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Introduction 


Introduction 

WAVECOM-BitView (W-BV) enables the user to analyze any bit stream. The range of functions extends 
from the display of a bit stream in various formats, simple bit stream manipulations, over statistical func- 
tions to complex mathematical functions and functions based on coding theory. The tools are targeted at 
users with experience in bit stream analysis. To understand some of the functions a comprehensive ma- 
thematical knowledge is a prerequisite. 

Direct bit stream input from W51PC, W61PC and W-CODE is supported. 

BitViewTool supports the Windows 2000, XP, 2003 Server and Vista operating systems. 

The product that you bought incorporates the latest technology in data decoding together with the latest 
software release available at the time of shipment. 

Please, check our website http://www.wavecom.ch for software updates. 

Always check the latest documentation on the installation CD or on our website. 

We thank you for choosing a WAVECOM decoder and look forward working with you in the future. 

This chapter introduces WAVECOM, the field of activity of the company, and how you may benefit from the 
expertise of WAVECOM. 

Throughout this document the terms "BitView", "W-BV" and "BitViewTool" all designate "WAVECOM- 
BitView". 


Training 

WAVECOM offers all our customers a complete, professional training program covering all the key features 
of our products. 

Depending on your skills (if you are an expert or a beginner), together we will work out a special training 
program for you. 

Training is available on your location or in Switzerland. 


Source Code 

Source code is available for government bodies. Please, inquire an offer from WAVECOM, if you plan to 
add your own modes. 


Company Profile 

WAVECOM ELEKTRONIK GmbH was founded in 1985 in Hohentengen, Germany, close to the Swiss border. 
In 1991 the company moved to Switzerland and established itself as WAVECOM ELEKTRONIK AG. Now lo- 
cated in Buelach it is within close vicinity of Zurich airport. 

The company has focused on decoding and analysis systems for wireless data transmissions. The wide 
product range spans from professional, high performance systems to devices for private and amateur ra- 
dio use. 

The very high quality standards combined with high system performance are appreciated by all customers 
worldwide. A global network of authorized sales partners ensures that local assistance and basic level sup- 
port can be provided in most places. More than 95% of all units sold are exported. The majority of the 
customers are government agencies, defense organizations and the telecommunication industry. 

About 40% of the turnover is invested in research and development. The employees at WAVECOM ELEK- 
TRONIK AG are mainly engineers with experience in DSP technology, computer and RF hardware devel- 
opment, and software engineering and radio data transmission. Access to external know-how and human 
resources enlarges the capabilities for realizing projects. Manufacturing is outsourced to specialized com- 
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panies within Switzerland which can handle today's needs for processing surface mount components and 
fine-pitch structures. 

WAVECOM ELEKTRONIK AG does not have any juridical or financial links or connections to other compa- 
nies or official bodies and is completely owned by Mr. Christian Kesselring. 


Revisions 


Version 

Date 

Changes 

1.1 

10. May. 2007 


2.0 

05. Nov. 2007 

Installation folders changed 
'Hide on close' preference added 

Layout settings removed from context menu 

Layout settings now in the property grid 

Graphic layout added 

'Inversion' function name inversion changed to 'polarity' 

Bit Sync Analysis added 

Custom library updated 

2.1 

14. Mar. 2008 

Hexadecimal view added 

Enhanced printer dialog 

MatLab custom libraries 

2.1.01 

15. Apr. 2008 

General overwork : 

> Improved readability 

> Extended explanations 

'Parameters' window changed to 'Properties' window 

2.2.00 

22.Jul.2008 

Works with W51PC, W61PC and W-CODE 

New functions: 

> Unzip 

> Autocalculation 

> Enable function 

2.3.00 

7. Feb. 2009 

New functions: 

> AND/OR/XOR/NOT Range 

> Extraction (Range) 

> General Reed-Solomon Decoding 

> Parity (Even/Odd/Mark/Space) 

> Parity from H-Matrix 

> Parity form polynomial 

> Descrambler (Pseudo Noise) 

> Pager Numeric 

Custom libraries with source code 

Additional information in the status line of the main window 

Enhanced performance of the Auto-Calculation function 

Functions may be enabled or disabled in History Explorer 


Requirements 

.NET Framework version 2.0 must be installed. The framework is included in the setup and is installed if 
missing on the system. 


Limitations 

In this version of BitView, the maximum number of bits that can be imported is limited to 500,000. 

Bear in mind that some formatting functions such as bit highlighting consume a lot of CPU power and may 
require considerable time to complete, especially on less powerful systems. Reducing the number of im- 
ported bits will speed up the application. 
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Bit streams are imported completely raw and unsynchronized, i.e., BitView will not recognize additional in- 
formation like confidence levels from soft-decoders or symbol boundaries for m-ary modulation types. Any 
such information must be removed using the BitView toolbox functions. 


Installation 


W-BV Software Installation 

To install the application, click SetupBitViewTool.exe. Files are then unpacked and copied to the instal- 
lation folder. Ini files are not generated. 

By default BitViewTool will be installed in the WAVECOM folder, where other WAVECOM products may be 
installed. 



Press Install to continue the installation of the four components which constitute BitView, 

• CodeMeter .NET API 

• CodeMeter Runtime 

• MatLab Runtime 

• BitView application 

The installation is self-explanatory and to complete it follow the instruction on the screen. 


CodeMeter .NET API installation 



Pressing Next will start the installation of this component. 
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CodeMeter Runtime installation 
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MatLab Runtime installation 
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BitView installation 
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BitView defaults installation 
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Press Finish to complete the installation of all BitView components. 



BitViewTool may be uninstalled by using the Add/Remove Programs item found in the Control Panel 
menu. 

Paths 

Examples and CustomLib files are copied to the following folder: 

Windows XP and earlier: 

• Documents and Settings\AII Users\Documents \WAVECOM\BitViewTool\ 

• Documents and Settings\AII Users\Shared Documents \WAVECOM\BitViewTool\ 

Windows Vista: 

• Users\Public\Public Documents\WAVECOM\BitViewTool\ 


W-BV Hardware Installation 

Apart from a Windows PC and software protection hardware, no additional hardware is required to operate 
the software. 

CmStick 

Software protection hardware has to be connected to the computer. The hardware device used for the 
software protection is called the CmStick and is available as: 

• A small USB device 

• A PC Card (CmCard/M, Cardbus, 32 Bit) 

• An Express Card 1 34 (CmCard/E) 

The W-BV application will not start if the appropriate and valid licenses are not found on a CmStick con- 
nected to the system. 
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After the installation of the software on the computer, the CmStick icon © will be displayed in the tray 
icon area. 


Note: when a CmStick is plugged into an USB socket of a LCD monitor, the CmStick will no longer be de- 
tected by the software protection server if the monitor is switched off. Hence a running application relying 
on the licenses stored on such a CmStick will stop working or disable its features. 


< ' 'RA* 12:29PM 


W-BV Licensing 

By default, two license models are available 

• W-BV with an update period of 12 months 

• W-BV with an update period of 36 months 

After the initial update period has elapsed, it is possible to order an extension for the update period by 
another 36 months. 

On request, we can generate different license models, even complex ones 

• Single user license 

• Evaluation licenses (number of starts, limited usage period, activation and/or expiration time) 

• Modular licenses (activation of additional functions) 

• Also licenses from other software manufacturers can be stored on a CmStick containing WAVECOM 
licenses 

W-BV Software Options & Updates 

Additional functions or services may be licensed to work with your tool, e.g.: 

• W-CODE decoder 

• W61PC decoder 

• Classifier 

• an extension by another 36 months of the software update period 
To process an order, the following information is required: 

• full address 

• ordered items 

• email or post delivery 

• serial number of CmStick 

• remote context file of CmStick to be updated, if applicable 

W-BV license checking 

To check the license(s) on the CmStick follow these steps: 

Click the © icon in the tray icon area. 
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Home Content Configuration Diagnosis Info Help 


Cluster User 


Available Licenses at 'rolf_haenggi' 


Product 

Code 

Name 

Feature 

Map 

Licenses 

Status 






User 

Limit 

No 

User 

Limit 

Exclu 

sive 

Shared 

Free 


100003 | Bundling Articles 

1 

SecuriKey 

Lite 

Oxl 

1 

0 

0 

0 

0 

1 

| Details | 


100787 | WAVECOM ELEKTRONIK AG 

1 

Standard 

Modes 

Oxf 

1 

0 

0 

0 

0 

1 

1 Details 1 


20 

SAT 

Modes 

Oxf 

1 

0 

0 

0 

0 

1 

1 Details 1 


30 

Classifier 

Oxf 

1 

0 

0 

0 

0 

1 

1 Details 1 

80 

W-BV 

Oxf 

1 

0 

0 

0 

0 

1 

1 Details 1 

100 

W-CODE 

Oxf 

2 

0 

0 

0 

0 

2 

1 Details 


Information last updated on 21.Jul.2008 14:38:49 


Item 

Remarks 

Product Code 

Displays the Product Code 

Name 

Displays the name of the Product Item, normally the name of the product 

Feature Map 

Displays the Feature Map. WAVECOM uses the Feature Map to control the software upgrade pe- 
riod 

Licenses 

Displays the total number of network licenses 

User Limit 

Displays the number of licenses, which are currently used in the User Limit mode 

No User Limit 

Displays the number of licenses that are currently used in the No User Limit mode 

Exclusive 

Displays the number of licenses that are currently used in the Exclusive mode 

Shared 

Displays the number of licenses that are currently used in the Shared mode 

Free 

Displays the number of licenses that are currently free 

Details 

Displays detailed information about the respective network licenses in use 


Important: If you have multiple CmSticks plugged into computers in a local network, then read the Co- 
deMeter and CmStick chapter included in the '' Appendix " on page 70. 


Getting Started 


Program Start 

Starting the program will introduce a license check procedure. 

If a valid license key was not found, the following message appears on the screen. 
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If a valid license key was found the application is started. The Toolbox, which contains the function li- 
brary, is displayed and enables the user to import a bit stream from a selection of different sources. 



Alternatively, using the New button from the Toolbar, an empty document window is opened which al- 
lows the user to manually create a bit stream, or copy and paste a bit stream from another source. 



Another option, using the Open button from the Toolbar, allows a previously saved Analysis Set (stored 
in an .XML file) to be opened (see later in this manual for details). 



Bit Stream Import 

An imported bit stream is shown in a document window, and the Properties and History Explorer win- 
dows are opened. In general, the Properties window displays all the properties of a selected function, 
and the History Explorer window shows the dependencies of all functions in a tree view. 
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Menu 


Bit Stream Processing 

An imported bit stream may be processed using any of the functions found in the library. 



The position of the cursor (line, column and index) in the bit display is continuously indicated in the bot- 
tom line of the application window. To select a number of bits, press and hold the left mouse button. The 
selected bits are marked in blue and the number of selected bits, and the decimal values of these bits in- 
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terpreted as big-endian or little-endian values are displayed in the bottom line. Left-clicking anywhere in 
the display window will cancel the selection. 

The processed bit stream is shown in a new document window. All document windows are shown as 
tabbed windows. 



Analysis Sets 

Functions and data may be combined to form a so-called Analysis Set, which contains an imported bit 
stream and the configured functions applied to the bit stream. The user may define and create different 
analysis paths, as may be seen in the History Explorer. The imported bit stream is processed according 
to the configuration settings of the selected functions. 

Using the Save button in the toolbar, Analysis Sets may be saved in an XML file. Using the Open button, 
an Analysis Set may be reloaded at any time. 
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- WAVECOM W61BitView 


BIS® 


: File 

Edit 

View 

Window 

Tools Setup 

Help 



i J 

( 9 ) 

( a \ 

id # 1 

* 

ES 


% 


: New 

\Openy 

l^Save J 

Print Help 

Toolbox 

History 

Property 

Recalc 

Report , 


^De-Stuffing [_CRcJ CRC-CCITT £Sl Shift il]jJ Mirroring I*!>) ASCII id Mirroring ▼ X 


01010001010000010000111001000001010110010001100100100110010100010 
10000010001011000100001011001010000001010000110000001010000111100 
1 10111010100110011101101010011001001110110011100111010010110000001 
01010000101101010011000000100110001101111011001110110001011101010 
01101100111000101110000001000010111010000110110101101010011011001 
11000000100000011100011011010000110110001101010011000000100101001 
10011011101010011001001110100111100000010010100110011011101010011 
00111011010010110011101101110011000000100001001101010111001001110 
10010110011101101110011000000100100000101010111011100110101011101 
10011100010111000000100010001101010011000101110111011101010011010 
10011001110110000001001000110010011100000011000000110000000100001 
01110111101100000010001001100100011000000110000001100101100100111 
0111 


Properties ? X 

:: ii les ™ Li vj j >i 

ffi Counter 
1=) Information 

Comment 

Hi Function name | De-Stuffing 

0 Graphic Display Configuration 

Bits per line 45 

B Bit Offset I 0 

0 Layout 

0 Bit & Text Display Configuration 


Counter 



Reports 

Using the Report button a complete Analysis Set may be generated and saved as a text file or a XML 
file. 



Example of a report stored in a text file. 
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£ Report_Packet 300-2.txt Notepad 

HUD® 

File Edit Format View Help 


b 

A 

Report generated by wavecom Bit view Tool 

Filename : Report_Packet-300-2.txt 

Date/Time : 01.11.2007 12:56:11 

Date/Time UTC : 01.11.2007 11:56:11 



Parent Function id : none 
This Function id : 1 

Analysis Name: Packet-300-2.txt 
FunctionName: import Text 
comment : 

FileName: Packet-300-2.txt 
Full Path: 

FileEncoding: us-ascii 
zeros: 8041 
Ones : 11984 
Bitcount: 20025 

Data: 

1110110111100100111011110001111011101010110110101001100111100001000110011 
1100010000101100001010100101101000110010001011000011110000110010001100100 
0100001110101011011010001001000010101000101010001010101101011000011111000 
1010100101101110110100010101000101010001001110110111100001111111011111110 
1111110111000001101110010011110101111110100111100001111100010110001111101 
1110110111110010111100110111011111011111011011111101111110011001110010101 
1110111011011111110111010111110100110001111011111010111110111101101101111 
1111100001011011111111101011111001111011111100011010011111101011111011111 
1110011001001111101011011001111111011000111101111111100110110111101111000 
1011101111111100000011100011111100100110111100011111001110010101101111010 v 


Example of a report stored in a XML file. 



Properties Window 

The parameters in the Properties window are grouped into different categories providing the operator 
with information about actual parameter settings and - more important - allowing the operator to confi- 
gure each function and to add comments. 

Detailed information about the selected parameter is displayed in the Comments area of the Properties 
window. 

In the Counter category information on the recorded bit stream, i.e., Bit count, number of logical Ones 
and number of logical Zeros is found. 

The Information category contains information on the selected source or analysis set, i.e., Analysis 
name, Comments (user input possible), File name (information only) and Function name (information 
only). Clicking the function name displays a brief description of the function. 
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History Explorer Window 

The History Explorer window provides a quick overview of the current analyzing process. It allows the 
operator to try out different function paths with different parameter settings and enables instant compari- 
son of the results of these trials. 


Functions may be re-arranged and deleted using the mouse pointer (drag-and-drop with left mouse button 
pressed and held) in combination with the modifier buttons (CTRL, ALT, SHIFT) or the mouse right-click 
menu. 


Keyboard button 

Function 

No keyboard button pressed 

Move and add dragged function 

CTRL pressed 

Copy and add dragged function 

ALT pressed 

Move and add dragged function plus all sub-functions 

SHIFT pressed 

Move and insert dragged function 

CTRL and ALT pressed 

Copy and add dragged function plus all sub-functions 

CTRL and SHIFT pressed 

Copy and insert dragged function 

SHIFT and ALT pressed 

Move and insert dragged function plus all sub-functions 

SHIFT/CTRL/ALT pressed 

Copy and insert dragged function plus all sub-functions 


When one of the modifier buttons is pressed while dragging, detailed information is displayed on top of the 
window, 


Baudot 150. xml 



If the History Explorer window has been hidden a list of functions applied is still available by clicking the 
arrow button in the top right corner of a document window. 
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Toolbox Window 

The Toolbox menu is divided into libraries, and each library contains one or more functions. 


Note: The Custom Library is not visible unless a custom function has been added. 

The Analysis Tools are not added to the History Explorer tree and are not persistently stored. 


1+) Source/Sink 
±1 Synchronisation 
1+) Binary Modulation 
1+) Bit Manipulation 
ID Decoding/Equalizer 
S CRC & Polynomial 
l±) Channel Decoding (Protocol) 
3 Source Decoding (Alphabet) 
g Latin (5) 
g Third-Shift Greek (5) 
g Cyrillic 
g] TASS Cyrillic (5) 
g] Third-Shift Cyrillic (5) 
g] Hebrew (5) 
g] Arabic Baghdad 70 (5) 
g] Arabic Baghdad 80 (ATU-80)(5) 
g] Bulgarian (5/8) 
g] Swedish (5/7) 
g] Danish-Norwegian (5/7) 
g] German (5) 
g] French (5) 
g) US (5) 
g] ASCII (7/8) 
g] UNICODE (16) 
g UTF-7 
g UTF-8 

±1 Analysis Tools 
1+) Custom Library 


Preferences 

The Preferences dialog box may be selected from the Setup menu. 

Substitution symbols for logical zero and logical one may be directly edited or selected using the appropri- 
ate Symbol button. 



If Automatically update all data on a parameter change is ticked, all functions are automatically re- 
calculated when the operator changes a parameter. Uncheck the tick box if this behavior is not desirable, 
and use the Recalc button in case a recalculation is necessary. 



If Hide document on close is ticked, a document is hidden when closed, but remains in the History Ex- 
plorer. Clicking the function associated with the document in the History Explorer will make the docu- 
ment visible again. 

To remove the function completely, select the appropriate function in the History Explorer and press the 
Delete key on your keyboard. 

If this option is not checked, documents are completely removed when closed. Closing the root document 
will close and remove all other functions and their associated documents. 
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If Graphic/Hex display changes in all documents option is selected, all the documents will have the 
same display settings, i.e., if the display is changed from graphic to hex in one document, and all other 
documents will change their display type as well. 


Layout Settings 

At run time, the user can drag and drop all windows to re-arrange them according to the preferred layout 
when not in auto-hide mode (map pin icon on window top line must be in vertical position). In the se- 
lected window press and hold the left mouse button and drag the window to the position you want it be in 
or just double-click the window and it will detach itself. 




In addition the Parameters, History Explorer and Toolbox windows use auto-hide functionality. To 
activate auto-hide for a window, click the map pin icon on the upper window line. The icon will change 
from vertical to horizontal position. 


Toolbox 

11 Ni 

L±J Source/Sink ir 

+J Synchronisation 

■ |Auto Hidef LUX 


The window is now hidden and a tab with its name appears on the side of the application window. To 
make the window appear, move the cursor to the tab. To hide the window again, double-click on the win- 
dow. 

To restore the application default layout, in the menu bar click View > Default Layout. 
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WAVECOM W61BitView 


si m 


|i □ & d 3 6J 

* 

\ m $ % & 

| : New Open Save Print Help | 

Toolbox 

History Property Recalc Report , 


File Edit View Window Tools Setup Help 


L±) Synchronisation 

□ Binary Modulation 

¥rj NRZ-I 
NRZ-M 
JjfiSj NRZ-S 

tlt] Bi-Phase-L (Manchester) 

^ Bi-Phase-M 
^ Bi-Phase-S 
DBi-Phase-M 
^ DBi-Phase-S 
±J Bit Manipulation 
±1 Decoding/Equalizer 
L±) CRC & Polynomial 
+J Channel Decoding (Protocol) 
l±) Source Decoding (Alphabet) 

□ Analysis Tools 
LjRitSrahkhf 


| Preamble ▼ ' 

j 111011011110010011101111000111101110101011 
j 011010100110011110000100011001111000100001 
I 011000010101001011010001100100010110000111 
100001100100011001000100001110101011011010 
001001000010101000101010001010101101011000 
011111000101010010110111011010001010100010 
101000100111011011110000111111101111111011 
111101110000011011100100111101011111101001 
111000011111000101100011111011110110111110 
010111100110111011111011111011011111101111 
110011001110010101111011101101111111011101 
011111010011000111101111101011111011110110 
g lioiiiiiiiiiooooioiioiiiiiiiiioioiiinooii 
■ 110111111000110100111111010111110111111110 
5 011001001111101011011001111111011000111101 
5 111111100110110111101111 """- 1 "- 1 - h h h h , , 


ojlzi 01 ilS i3 SI 


Counter 
- Information 

Analysis name 
Comment 

File encoding 
File name 
Function name 


Packet-300-2.txt 


US-ASCII 

Packet-300-2.txt- 


Import Text 

- Graphic Display Configuration 

45 



Cursor Pos: Ln=l, Col=l i Selected Chars: 0 


Use View > Default Layout to use or restore the default layout of the windows. 


WAVECOM W61BitView 



View | Window Tools Setup Help 


| v | Toolbar 
| | Status Bar 

|^| Toolbox 
fh] History Explorer 
Properties 
Default Layout 



51 

oolbox 

History 

ASCII 

firs 


L0011101DI 

L00000101I 

3001011101 

1011101111 

001000111 


More than one Analysis Set may be active at a time. Using the Window menu allows the user to show or 
hide these Analysis Sets. 



The layout and display settings can be configured from the upper part of the Properties window. 
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: / 1 es- 


B i Graphic Display Configuration; 

Bits per line 45 

± 


Bit Offset 

0 

B Layout 



Border width 

3 


Bit rectangle heigth 

4 


Vertical distance of bits 

1 


Color of 'O', inactive 

□ DarkGray 


Color of T, inactive 

□ White 



.Color of 'O', active 

■ Blue 


1 

^olor of T, active 

H Red 


B 

Bit & Text Display Configuration 



Word Wrap 

P Enabled 



Format options 

(• None 

C Bits per line 

C Bitfield alligned 



Bits per line 

45 



Bit Field Alignment 




Highlighting 

r Disabled 



Highlight Bitfield 0 




Highlight Bitfield 1 




Highlight Bitfield 2 




Highlight Bitfield 3 



B HexView Configuration 



Endianness 

(* Little endian 

C Big endian 


Graphic Display Configuration 


Using the Bit & Text Display Configuration category in the Properties window enables the operator to 
use different display format options listed below. 



Word Wrap 

Checking the Word Wrap Enabled tick box enables word wrapping in the bit and text document. 

Bits per line 

This parameter allows displaying a specific number of bits per line. Choose the Bits per line radio button 
under format options to enable this feature. 

Bitfield alignment 

Whenever the specified bit pattern is found in the bit stream, a new line is started, i.e., a line break is in- 
serted. Choose the Bitfield aligned radio button under format options to enable this feature. 

Highlighting 

The bit stream is searched for a specific bit pattern and when found the pattern is marked. A maximum of 
four different search patterns are possible. Check the Highlighting tick box to enable this feature and en- 
ter the search patterns in the appropriate text fields. 
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Display options 

In addition to the document window(s), two additional views of the bit stream being analyzed are availa- 
ble at the bottom of the document window(s): one is a graphical display and the other one a hexadecimal 
display. 


Graphic Display 

A graphic display is associated with the bit stream and may be selected from the top of the Properties 
window clicking the Show Graphics bit view icon. 



The vertical size of the graphic display can be changed by dragging its top border. 

The Layout category let you change the appearance of the graphic display. 

In the Graphic Display Configuration category the number of bits per line can be set. This feature can 
be used to find periodic bit patterns in the bit stream by changing the number of bits per line until a re- 
peating bit pattern is visible. It is much easier to find those patterns using the graphic display than to use 
the hex display. 

The arrow buttons on top of the Properties window are designed to move the active selection in the 
graphic display. The selected bits are displayed as Raw Bits in the bottom of the graphic display. 


When the cursor is placed in the graphic display, the cursor changes into a cross hair and a context win- 
dow indicates the position of the cursor (offset, row and column). Holding the right mouse button allows 
the user to zoom in on the selected area. Right-clicking will make an Unzoom button appear. Use this 
button to un-zoom the selected area. 



It is possible to zoom into the graphic display. Hold the left mouse button down and select the area that is 
to be expanded. A right click on the graphic display shows the context menu for un-zooming the view. 


Hex Display 


A hex display may be selected by pressing the Show Hex view button on top of the Properties window. 
This display option offers a standard hex dump layout consisting of an offset in hexadecimal notation, 
hexadecimal characters separated by a space and finally the data in ASCII characters. 


The interpretation of 8-bit frames can be toggled between Little and Big endian in Hex View Configu- 
ration, Endianness, i.e., "00101100" is displayed as 0x34 when interpreted as little endian and as 0x2c 
when interpreted as big endian. 


j & d j «• n*n 51 & ^ * 

New Open Save Print Help Itoobox | History Property Recalc Report 
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The printer dialog is used for print preview and the printer settings. Use it by clicking the Print button or 
by selecting the menu entry File > Print. All layout settings, i.e., highlighting, alignment or bits per line, 
are supported. 



Function Library 


Common Functions 


Auto-Calculation 

To test a hypothesis regarding the properties of a bit stream, the operator may wish to test a property 
within a specific range of values. This task can either be conducted by changing the parameter value ma- 
nually and then checking the outputs one by one or it can be performed automatically. That is where Au- 
to-Calculation comes into play. 

A right click on the parameter name (not the value) in the parameters window opens a context menu. 
Click Reset to change parameters to their default values or click AutoCalc Setup to open the Auto- 
Calculation window: 
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Start and stop values for the selected parameter must be chosen using the Value range starts at and 
Value range stops at parameters. The auto-calculation function then needs to be told which function will 
monitor the calculation output by use the function drop-down menu of the Monitor function name pa- 
rameter - the function MUST be lower in the function tree as displayed in the History window. Automatic 
calculation can now be started by clicking the Start button. 



The result of the auto-calculation is displayed in the left side of the Auto-Calculation window. Edit > 
Quick find can be used for searching the auto-calculated output. 
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Enable or Disable Functions 

Functions in the analysis tree can easily be enabled or disabled by checking or un-checking the checkbox 
next to the function in the History Explorer. 



Source/Sink 

Bit streams stored in text files may be imported and differently interpreted according to the three file con- 
version formats available. A real-time bit stream will always be interpreted as binary ones and zeros. 

Import Text Data 

Input: Off-line bit stream 
Function: 

Imports a bit stream from a text file. Only ASCII ones ("1", 0x31) and zeros ("0", 0x30) are considered as 
valid characters, others values are ignored. 

Example: "0110w700" is imported as "011000". 

Import Hex Data 

Input: Off-line bit stream 
Function: 
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Imports a bit stream from a text file. Only ASCII figures from "0" (0x30) to "9" (0x39) and letters from 
"A" (0x41) or "a" (0x61) to "F" (0x47) or "f" (0x67) are considered as valid characters, others values are 
ignored. 

Example: "albgOclkdO" is imported as "10100001101100001100000111010000" 

Import Binary Data 

Input: Off-line bit stream 
Function: 

Imports a bit stream form a text file. All 8 bit ASCII characters"(0x00...0xFF) are considered as valid cha- 
racters. 

Example: "KanlZc" is imported as "0100101101100001100111000011000101011010" 

Import IAS Bitstream 

Input: Real-time bit stream 

[^New Import 

Stop 

IS 7 zi | M 



Function: 

Directly transfers a real-time bit stream from WAVECOM Server, the application that manages WAVE- 
COM decoder cards. 

Before starting a bit stream import into BitView, the desired mode must be started in the WAVECOM de- 
coder. 

In order to be able to connect to the server, the following settings are required: 


Parameter 

Value 

Bitstream 

This command will configure WAVECOM Server to run code appropriate to the selected de- 
coder mode. The choices are: HF (default setting), VHF- direct or VHF-indirect 

Card/Device number 

For W51/W61 enter the decoder card number. For W-CODE enter the device number. 

These numbers are found in the decoder Setup menu 

IP address 

Enter the IP address or MS computer name of the PC that hosts WAVECOM Server. Default 
is 127.0.0.1, which must be used for a WAVECOM decoder and BitView installed on the 
same host 

Port 

Enter the port number of the XML Remote Control Interface (RCI) of WAVECOM Server. 
Default is port 33244 (see WAVECOM Server Control | Networking Information) 

Recording duration 

Enter the desired duration of the recording in seconds. 'O' means infinite 

Timeout 

Maximum time to establish a connection to WAVECOM Server. If a connection to the server 
could not be established within this period of time, the application cancels the connection 
procedure 


26 • Function Library 


BitView Manual V2.3.00 WAVECOM W-BV 




To start importing press the New Import button on top of the Properties window. The document win- 
dow will display Recording.... and the same text will be displayed blinking in the display bottom line. The 
WAVECOM decoder screen will display Sending bitstream to external application... 

To stop importing press the Stop button on top of the Properties window. After importing of an IAS bit 
stream has been stopped, the Bit Sync Analysis/Import IAS Bitstream function automatically opens. 

Stopping the BitView import will not stop the decoder bit stream, nor will a decoder detect that the Bit- 
View Tool has been closed. Similarly BitView will not detect that the selected decoder mode has been 
closed. 

If BitView cannot establish a connection with WAVECOM Server the Recording... status indication will dis- 
appear. 


Export Text Data 

Input: Current document window contents 

Output: Text file 

Function: 

Write the contents of the current document to a text file. A Save As dialog will appear from which to se- 
lect a filename and a folder for the exported file. 


Synchronization 

Preamble 

In: Bitstream 
Out: Bit stream 



Function: 

Searches for the Preamble value in the incoming bit stream and then writes the number of Bits after 
Preamble to the output. If the bit stream contains more than one preamble, the parameter Ignore 
preambles can be set for the function to skip a certain number of preambles. 


Binary Modulation 


NRZ-I 


In: Bitstream 
Out: Bit stream 



(sTl^i m i@ n a 


+ Counter 
S Information 


Comment 



Q Graphic Display Configuration 


Bits per line 

45 

| Bit Offset 

0 


® Layout 

ffl Bit & Tent Display Configuration 


Function name 

l\IRZI (Non-Return-To-Zero Inverse) 
decoding function: 
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Function: 

Changes the bit stream according to the "Non Return to Zero Inverse" (NRZ-I) decoding scheme, where 
no bit change represents a '1' and a bit change represents a 'O'. 

NRZ-M 

In: Bitstream 
Out: Bit stream 



Function: 

Changes the bit stream according to the "Non Return to Zero Mark" (NRZ-M) decoding scheme, where a 
bit change represents a '1' and no bit change represents a 'O'. 

NRZ-S 

In: Bitstream 
Out: Bit stream 



Function: 

Changes the bit stream according to the "Non Return To Zero Space" (NRZ-S) decoding scheme, where no 
bit change represents a '1' and a bit change represents a 'O'. 

Note: This function is identical to NRZ-I. 

Bi-Phase-L (Manchester) 


In: Bitstream 
Out: Bit stream 



3 Counter 
0 Information 


Comment 

3 Graphic Display Configuration 

Bits per line 45 

BBitOffset^lc^^^^^l 

ffi Layout 

0 Bit Cc Text Display Configuration 

Function name 

Bi-Phase-L (Manchester) decoding 
function: 

Function: 

Analyze the bit changes of the bit stream. A change from '1' to '0' represents a '1' and a change from '0' 
to '1' represents a 'O'. The bits are analyzed in pairs, i.e., the number of output bits is half the number of 
input bits. 
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Bi-Phase-M 

In: Bitstream 
Out: Bit stream 


Properties Q X 


ill: | z 1 

ffi 

a 


B Graphic Display Configuration 

Bits per line 45 

B Bit Offset 1 0 ~ 

ffi Layout 

ffi Bit & Text Display Configuration 

Function name 

Bi-Phase Mark decoding function: 

Level change occurs at the beginning of 
every bit period 

A midbit level change represents a T, 
no midbit level change represents a 'O'. 

Function: 

In Bi-Phase-M encoding, a logical '1' is represented by a pair of bits of opposite values ('10' or '01'). A log- 
ical '0' is represented by a pair of bits of the same values ('00' or 'll'). The decoding procedure halves the 
number of output bits. 


Counter 

Information 

Comment 

Bi-Phase-M 


Bi-Phase-S 

In: Bitstream 
Out: Bit stream 



Function: 

In Bi-Phase-S encoding, a logical '0' is represented by a pair of two bits of opposite values ('10' or '01'). A 
logical '1' is represented by a pair of bits of the same value ('00' or 'll'). The decoding procedure halves 
the number of output bits. 


DBi-Phase-M 

In: Bitstream 
Out: Bit stream 



Function: 

Two bits form a bit period. A bit change at the beginning of a bit period represents a 'O', while no bit 
change at the beginning of a bit period represents a '1'. 
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DBi-Phase-S 

In: Bitstream 
Out: Bit stream 



Function: 

Two bits form a bit period. A bit change at the beginning of a bit period represents a '1', while no bit 
change at the beginning of a bit period represents a 'O'. 


Bit Manipulation 

De-Stuffing (HDLC) 

In: Bitstream 
Out: Bit stream 



Function: 

Removes stuff bits inserted in the input bit stream. If a zero bit is detected after five contiguous Ones, the 
Zero bit will be removed. 

Example: "111101" is changed to "111111". 

Mirroring 

In: Bitstream 
Out: Bit stream 



Function: 
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The mirroring function modifies the incoming bit stream frame by frame. The Frame length is user de- 
fined. The function changes the bit order within each frame. 

Example with a frame size of 5 bits: 

"10111 01101" is changed to "11101 10110". 

Rotation 

In: Bitstream 
Out: Bit stream 



Function: 

The rotation function modifies the incoming bit stream frame by frame. The Frame length is user de- 
fined, as well as the Rotation direction and the Number of bits to be rotated. 

Example with a frame size of 5 bits, left rotation direction and one rotation step: 

"10111 01101" is changed to "01111 11010". 

Shift 


In: Bitstream 
Out: Bit stream 



Configuration 

Fill bit value 

Zero 

Frame length 

8 

Number of bits 

1 

Shift direction 

Left 


+ Counter 


0 Information 

Comment 



0 Graphic Display Configuration 

Bits per line 45 

■ BitOffset^^lo^^^^^^ 

® Layout 

+ Bit & Text Display Configuration 


Function name 

Shift function 

Function: 

The shift function modifies the incoming bit stream frame by frame. The Frame length is user defined, as 
well as the Shift direction, the Number of bits to be shifted and the Fill bit value. 

Example with a frame size of 5 bits, left shift direction, two bits shift and a fill value of '1': 

"10111 01101" is changed to "11111 10111". 


Polarity 

In: Bitstream 
Out: Bit stream 
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Function: 

Invert the bit stream according to the Bits to change polarity pattern. At positions marked with a One, 
the bit is inverted, at positions with a Zero, the bit remains unchanged. 


Example: 

#1 

#2 

#3 

Bits to change polarity 

111000111 

1 

0 

Input 

111111111000000000 

111111111000000000 

111111111000000000 

Output 

000111000111000111 

000000000111111111 

111111111000000000 


De-Interleave Bit Block 

In: Bitstream 
Out: Bit stream 



Function: 

Change the bit order according to the settings of Block length, Frame length and Interleaving dis- 
tance. The easiest way to understand the de-interleaving function is a closer look at the examples below 
(imagine that the bit stream is written horizontally into the buffer and read out vertically): 


Example: 

#1 

#2 

Interleaving distance 

3 

2 

Block length 

12 

16 

Frame length 

1 

2 

Input 

000111000111 

0011001111100010 

Matrix 

000 

00 11 


111 

00 11 


000 

11 10 


111 

00 10 

Output 

010101010101 

0000110011111010 


De-Interleaving Stream 

In: Bitstream 
Out: Bit stream 
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Properties 


[iii]ai a si a a 

Q Configuration 


Offset into Bit Bu... 

0 

Interleaving dist... 

1 

Output frame len... 

1 

Counter 

Information 

Comment 



De-Interleaving-i.tr>: 


- 1 Graphic Display Configuration 


Bits per line 

45 

| Bit Offset 



Layout 

ffl Bit & Text Display Configuration 


Function name 

De-Interleaving-Stream function 


Function: 


Change the bit order according to the settings of Offset into Bit Buffer, Output frame length and In- 
terleaving distance. 

The Offset into Bit Buffer tells the function where to start the de-interleaving function. Is Offset into 
Bit Buffer for example set to 3, then the first 3 bits will not be used for calculation of the output data. Ac- 
cording to the Output frame length setting, the output data will be less than the input data. The easiest 
way to understand the de-interleaving stream function is a closer look at the example below (imagine that 
the bit stream is written horizontally into the buffer and read out vertically): 

Example 1: 

Offset into Bit Buffer = 0 


Interleaving distance = 15 
Output frame length = 4 


bO distance bl4 

/ -> | 000000000000000 | 
output / -> 1 111111111111111 1 =\ 

frame \ -> [0000000000000001 =/ 

length \ -> | 111111111111111 | 


| 000000000000000 | 
1 111111111111111 1 
| 000000000000000 | 
1 111111111111111 1 
I I I I 


bO b59 

I 

000000000000000111111111111111000000000000000111111111111111 . . 


input stream 
0101 output frame 0 
0101 output frame 1 
0101 output frame 2 
0101 output frame 3 


"000000000000000111111111111111000000000000000111111111111111" is changed to "0101010101010101 '* 


Example 2: 

Offset into Bit Buffer = 3 


Interleaving distance = 8 
Output frame length = 4 


011101100111000111100001111100000111111000000111111100000001111 


1101 output frame 0 
0110 output frame 1 
1011 output frame 2 

1100 output frame 3 
0110 output frame 4 
1001 output frame 5 

1101 output frame 6 
0010 output frame 7 
1011 output frame 8 


' , 101100111000111100001111100000111111000000111111100000001111 ,, is changed to "110101101011110001101001110100101011" 


AND / OR / XOR / NOT 

In: Bitstream 
Out: Bit stream 



Function: 
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The output bit values depend on the selected logical operation (Logical operator) performed on the input 
bits. The first operand is the input bit stream, while the second operand (Frame) is constant and can be 
either 'O' or '1'. 

AND / OR / XOR / NOT Range 



In: Bitstream 
Out: Bit stream 


Function: 

The output bit values depend on the selected logical operation (Logical operator) performed on the input 
bits from Offset to first frame and over Number of frames. The first operand is the input bit stream, 
while the second operand (Frame) is constant and can be 'O' or 



Extraction (Mask) 

In: Bitstream 
Out: Bit stream 


Function: 

Extracts bits from the incoming bit stream using the user defined Mask. Only positions marked with a '1' 
are extracted. The output bit stream is calculated frame by frame. 

Example: "111110" with mask "110" changes to "1111". 



Extraction (Range) 

In: Bitstream 
Out: Bit stream 


Function: 
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Extract Extraction length bits from the incoming bit stream starting at Extract start position. 

Cutting 

In: Bitstream 
Out: Bit stream 



Function: 

Cuts Cut length bits, beginning at Cut start position. Note that counting starts at zero, i.e., the first 
element in the bit stream is number 0. 


Decoding/Equalizer 

Viterbi-Decoding 

In: Bitstream 
Out: Bit stream 



Function: 

Decode the incoming bit stream using the Viterbi algorithm - a maximum-likelihood decoding procedure 
for convolutional codes. 


Parameter 

Constraint length 

Equals n + 1, where n is the length of the shift register in the encoder 

Decision best state 

Use best state or not 

Last decoder state 

Initial state of the decoder 

Metric 

Select hard or soft decision 

Mode 

Select whether the input data should be treated as a continuous stream or a stream of 
bursts. 

Soft decision bits 

If soft decision is used, enter the number of soft decision bits 


De-Puncturing 

In: Bitstream 
Out: Bit stream 
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Function: 

This function adds de-puncturing bits and probability bits to the input bit stream. 


Parameter 

Value 

Frame 

Bits are inserted according to the entered bit pattern. The length of the bit pattern corres- 
ponds to the frame length. At positions marked with a 'O', a bit is inserted. Additionally, for 
every input bit, a probability bit is added. For received bits (marked with a '1' in the frame 
pattern), a '1' probability bit is added - for inserted bits, a '0' probability bit is added (equals 
a probability of 0.5) 


Example with a frame pattern of "110": 

The frame pattern "110" means that after two input bits, a de-puncturing bit must be inserted so "1111" 
becomes "111100111100". 


Difference-Decoding 

In: Bitstream 
Out: Bit stream 



Function: 

This function performs difference decoding, which is a logical XOR operation on the previous output bit 
and the current input bit. The Start bit value is user defined. 

Example with start bit value of '1': 

"01101110" is changed to "10110100". 

BCH-Decoding 

In: Bitstream 
Out: Bit stream 
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Function: 

Decodes BCH encoded bit streams. 

The function returns the parameters listed in the table below. 


Parameter 

Description 

Corrected errors 

Number of corrected errors 

Error Positions 

Positions of detected errors 

Generator Polynomial 

Encoding generator polynomial on the form g(x) = 111... 

Minimum distance 

This property determines the number of detectable errors and the number of correctable 
errors 

Number of frames 

Number of frames in the decoded bit stream 

Order of Galois field 

Property of the field of numbers to which a given BCH code belongs 

Original data length 

Length of original code word 

Primitive polynomial 

A polynomial describing a given BCH code 


Parameter 

Description 

Value 

BCH algorithm 

Algorithm used to find BCH polynomial 

Berlekamp-Massey, Euclid 

Code word length 

Length of code word including redundancy 



bits. 


Max errors 

Error correction capability 



Example with code length 15 and error correction capability 3: 
"011001010000111" is changed to "00111". 

Block Code Analysis 

In: Bitstream 
Out: Bit stream 



Function: 
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Identify forward error correction block codes like BCH, RS, CRC or Hamming. 

The function returns alphabet size (normally equal to 2 because input is a binary bit stream), block code 
type (BCH, RS, etc.), code word length estimation (n), generator polynomial, input length estimation (k) 
and code rate estimation (R = k/n). 

The function will identify the following Block Code Types, 

Unidentified code 
BCH 

CRC or perfect cyclic code 
Binary repetition (reversals) 

Binary Golay 
Binary Hamming 
CRC block code 
Non-cyclic block code 

The generator polynomial is returned as a string of ones and zeros, starting at the lowest order of 2^x, 
e.g., 1001110010101 means 1 + x^3 + x'M + x^5 + x^8 + x'MO + x /v 12. 

The results of the analysis are displayed in a new document window and in the Calculation category in 
the Properties window. The table below lists the calculated parameters. 


Parameter 

Description 

Alphabet size 

Size of input alphabet 

Block code type 

Type of block code used 

Codeword length es- 
timation 

Length of input code word (n) , i.e., number of data bits (k) plus number of checksum bits 
(n-k) 

Generator polynomial 

Generator polynomial (G(x)), i.e., the polynomial used to generate the checksum 

Input length 

Estimated number of data bits per code word 

Rate estimation 

Code rate (R = k/n), i.e., ratio between number of data bits (k) and total number of bits 
per frame (n+k) 


Constraints: Frames must have equal length and if the bit stream is delimited by flags they must be re- 
moved with the Extract or Cut functions. 


Convolutional Code Analysis 

In: Bitstream 
Out: Bit stream 



Function: 

Find the parameters of convolutional encoded bit streams. 

The function returns constraint length (K), number of input bits per shift cycle (k), number of output bits 
per shift cycle (n) and generator polynomials. The function will search for K = 2. .14, and n = 2. .4. The 
numbers of returned generator polynomials depend on the number of output bits per shift cycle (n). 

The results of the analysis are displayed in a new document window and in the Calculation category in 
the Properties window. The table below lists the calculated parameters. 
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Parameter 

Description 

Gen. Polyl 

Generator polynomial 1 found 

Gen. Poly2 

Generator polynomial 2 found 

Gen. Poly3 

Generator polynomial 3 found 

Gen. Poly4 

Generator polynomial 4 found 

Input bits (k) 

Number of input bits to convolutional encoder 

Constraint length (K) 

Constraint length, i.e., the number of bit in encoder memory affecting the generation of n 
output bits 

Output bits (n) 

Number of output bits from convolutional encoder 


General Reed Solomon Decoding 


In: Bitstream 
Out: Bit stream 



:: 51 

4 

□ Calculation 

__ 

Frames with corrected errors 

1 0 


Frames with decoding failures 

1 2 


Frames without errors 

0 


M (Bits per symbol) 

8 


N (Max. length of codeword) 

255 


. Number of frames 

| 2 1 


□ Configuration 



K (Length of data) 

249 


Number of parity symbols 

6 


Output with Parity Symbols 

No 


Position of Parity Symbols 

End of code word 


Primitive polynomial 

1 + x + x A 2 + x A 7 + x A 8 


Root for generator polynomial 

n 


E Counter 


_ Bit count 

3984 


Ones 

2106 


Zeros 

1878 

E Information 


Comment 



■ General Reed-Solomon 

▼ 


Function name 


General Reed-Solomon Decoder 



Function: 

Decodes bit streams which are encoded with a Reed-Solomon code. 
The decoder must be configured by the parameters listed below. 


Parameter 

Description 

Value 

Length of data (k) 

Number of data symbols in a code word, where the number of data 
bits (k) is less than the total number of bits (k), i.e., k < n 


Number of parity 
symbols 

Number of parity symbols in a code word (n-k) 


Output with Parity 
Symbols 

Specifies if parity symbols should be included in the output 

Yes, No 

Position of Parity 
Symbols 

Specifies if parity symbols are leading or trailing the code word 

End of code word, 
Beginning of code 
word 

Primitive poly- 
nomial 

Encoding polynomial 

Select from drop- 
down list 

Root for generator 
polynomial 

Root for generator polynomial. See parameter help desk for further 
explanation 



The results of the analysis are displayed in the Calculation category in the Properties window. The table 
below lists the calculated parameters. 


Parameter 

Description 

Frames with corrected errors 

Number of frames with correctable errors 

Frames with decoding failures 

Number of frames with decoding errors 
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Frames without errors 

Number of frames without errors 

m (bits per symbol) 

Number of bits per symbol (m) 

n (max. length of code word) 

Maximum number of symbols per code word. N is derived from the selected 
primitive polynomial 

Number of decoded frames 

Number of decoded frames 


CRC & Polynomial 

CRC (1..32) 

In: Bitstream 
Out: Bit stream 



Function: 

Calculate the cyclic redundancy checksum (CRC) value of the input bit stream according to the settings 
described below. 


Parameter 

Value 

Augment Zero Bits 

Calculate CRC with or without augmented (added) zero bits 

Crc Bits Appended 

Are CRC bits appended to the bit stream (Yes or No) 

Final Xor Value 

Final XOR value in hex 

Initial Value 

Initial value in hex 

Order 

Polynomial order (1..32) 

Polynomial 

Polynomial in hex 

Reverse Data Bytes 

Reflect data byte before processing (Yes or No) 

Reverse Result Before Xor 

Reflect final result before XOR (Yes or No) 


The calculated CRC value is displayed in the Crc Calculated field. If Crc Bits Appended is set to 'Yes', 
then the Crc Transmitted field contains the transmitted CRC value in hex format. If there are no ap- 
pended CRC bits, then the Crc Transmitted field has no meaning. The transmitted CRC value is also dis- 
played in inverted format (Crc Transmitted Inverse). 

CRC-8 

In: Bitstream 
Out: Bit stream 
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Function: 

Calculate the standard CRC-8 values of the incoming bit stream. 

The calculated CRC value is displayed in the Crc Calculated field. If Crc Bits Appended is set to Yes, 
then the Crc Transmitted field contains the transmitted CRC value in hex format. If there are no ap- 
pended CRC bits, then the Crc Transmitted field has no meaning. The transmitted CRC value is also dis- 
played in inverted format (Crc Transmitted Inverse). 

CRC-10 

In: Bitstream 
Out: Bit stream 



Function: 

Calculate the standard CRC-10 values of the incoming bit stream. 

The calculated CRC value is displayed in the Crc Calculated field. If Crc Bits Appended is set to Yes, 
then the Crc Transmitted field contains the transmitted CRC value in hex format. If there are no ap- 
pended CRC bits, then the Crc Transmitted field has no meaning. The transmitted CRC value is also dis- 
played in inverted format (Crc Transmitted Inverse). 


CRC-12 

In: Bitstream 
Out: Bit stream 



Function: 

Calculate the standard CRC-12 values of the incoming bit stream. 
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The calculated CRC value is displayed in the Crc Calculated field. If Crc Bits Appended is set to Yes, 
then the Crc Transmitted field contains the transmitted CRC value in hex format. If there are no ap- 
pended CRC bits, then the Crc Transmitted field has no meaning. The transmitted CRC value is also dis- 
played in inverted format (Crc Transmitted Inverse). 


CRC-16 

In: Bitstream 
Out: Bit stream 



Function: 

Calculate the standard CRC-16 values of the incoming bit stream. 

The calculated CRC value is displayed in the Crc Calculated field. If Crc Bits Appended is set to Yes, 
then the Crc Transmitted field contains the transmitted CRC value in hex format. If there are no ap- 
pended CRC bits, then the Crc Transmitted field has no meaning. The transmitted CRC value is also dis- 
played in inverted format (Crc Transmitted Inverse). 


CRC-CCITT 


In: Bitstream 


Out: Bit stream 


TaWfzl | H B 51 51 

- Calculation 

■ CrcCalculated 1 
CmTransmitted 
CrcTransmittedl... 

0 Configuration 


AugmentZeroBits 

No 

CrcBitsAppended 

Yes 

Counter 

Information 

Comment 



[CRC-CCITT ~ 


0 Graphic Display Configuration 

Bits per line 45 

U Bit offset ! 0 

+ Layout 

ffi Bit & Text Display Configuration 

Function name 

CRC-CCITT 


Function: 


Calculate the standard CRC-CCITT values of the incoming bit stream. 

The calculated CRC value is displayed in the Crc Calculated field. If Crc Bits Appended is set to Yes, 
then the Crc Transmitted field contains the transmitted CRC value in hex format. If there are no ap- 
pended CRC bits, then the Crc Transmitted field has no meaning. The transmitted CRC value is also dis- 
played in inverted format (Crc Transmitted Inverse). 


CRC-32 

In: Bitstream 
Out: Bit stream 
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Function: 

Calculate the standard CRC-32 values of the incoming bit stream. 

The calculated CRC value is displayed in the Crc Calculated field. If Crc Bits Appended is set to Yes, 
then the Crc Transmitted field contains the transmitted CRC value in hex format. If there are no ap- 
pended CRC bits, then the Crc Transmitted field has no meaning. The transmitted CRC value is also dis- 
played in inverted format (Crc Transmitted Inverse). 

Parity (Even/Odd/Mark/Space) 

In: Bitstream 
Out: Bit stream 



Function: 

Calculate the parity of frames. 

Enter Frame length and Parity type from the drop-down list. 

The function returns Number of faulty frames and Total number of frames in the Calculation cate- 
gory and in a document window the selected matrix and a list of the processed frames in bit notation and 
parity marked as Parity o.k. or Parity error. 

Parity from H-Matrix 

In: Bitstream 
Out: Bit stream 



Function: 
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Calculate the parity of frames using H-matrix multiplication. 

By clicking the H-matrix setup field a drop-down list appears. Enter the matrix size in the Rows and 
Columns fields, then proceed to fill in logical '1' in the appropriate positions of the matrix by left-clicking 
the position. A context label indicates the cursor position. 



The function returns Number of code words processed in the Calculation category and in a document 
window a list of the analyzed frames and the calculated parity bits in bit notation and parity marked as 

Parity o.k. or Parity error. 

Parity from polynomial 

In: Bitstream 
Out: Bit stream 



Function: 

Calculate the parity of frames by generating an H-matrix from the corresponding cyclic linear block code 
generator polynomial. The bit stream is then multiplied by the generated H-matrix. 

The parameters listed below configure the function: 


Parameter 

Description 

Value 

Data length in code word 

Number of data bits in code word 


Generate H-matrix 

Generate H-matrix 

Yes, No 

Generator polynomial (standard 

Use the drop-list to open a window for entering the 

Example: 

format) 

generator polynomial 

l+x+x A 2... 

Reverse bit order in data field 

Reverse bit order in the data part of code word 

Yes, No 

Reverse bit order in gen. poly. 

Reverse bit order in generator polynomial 

Yes, No 


The function returns these parameters: 


Parameter 

Description 

Code word length 

Total length of code word (data and parity bits) 

Number of code words 

Number of complete code words 

Number of code words with error 

Number of code words with bad parity 
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Unpacking/Decompress 


Unzip 

In: bit stream 


Out: bit stream 



Function: 

The unzip function decompresses a ZIP archive from the input bit stream using the standard DEFLATE al- 
gorithm. 

If the function is able to detect compressed files in the bit stream, the names of these files is shown in the 

Files in Archive field. 


The output of this function can be processed further by using other functions or can be saved into files. 
The Unzip to disk function is started by pressing the Start button. If a password is required enter it in 
Password. A file dialog will appear to select the folder for the decompressed files. 

If a file is corrupted or data is missing and Extract corrupted files is set to No, an error message will 
appear when the decompression of the corrupted file has completed. If Extract corrupted files is set to 
Yes, damaged archives will be processed without an error message. It should be noted however, that if 
essential parts of the file header are in error the function may be unable to decompress the file. 


Descrambling 

Descrambler (PN) 



In: Bitstream 
Out: Bit stream 


Function: 

Descramble a bit stream scrambled with a scrambling polynomial (pseudo random sequence). The poly- 
nomial is entered using the Descrambler config field. Clicking the drop-down list will open a shift regis- 
ter schematic with 16 stages each representing in increasing order the elements of the scrambling poly- 
nomial. 
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D In & 1 2 3 4 5 6 7 8 9 10 11 12 13 14 IS 16 

^ » Unscrambled Out G*] 

A click on the tick box for each stage enables or disables the individual stage. Clicking a stage icon will 
toggle its initial state between 1 and 0. When configuring the descrambler is complete click Ok to save the 
configuration, which is displayed in the Characteristic polynomial and Initial shift register state 
fields. 


Channel Decoding (Protocol) 

The channel decoding functions convert a number of channel coded input bit streams into ITA-2 or ITA-5 
bit streams. The Properties windows for these functions are identical to the figure below, and thus they 
will not be reproduced for every single function. 



t±) Counter 
Q Information 


Comment 

■ Input frame length 7 

Output frame len... j 5 

a Graphic Display Configuration 

Bits per line 45 

■ BitOffset^^^Jo^^^^^ 

ffl Layout 

a Bit & Text Display Configuration 


Function name 

Converts an ARQ-E coded bit stream to an 
ITA-2 bit stream. 


ARQ-E 

In: Bitstream 
Out: Bit stream 
Function: 

Convert an ARQ-E coded bit stream into an ITA-2 bit stream. 

SITOR 

In: Bitstream 
Out: Bit stream 
Function: 

Convert a SITOR coded bit stream into an ITA-2 bit stream. 

FEC-A 

In: Bitstream 
Out: Bit stream 
Function: 

Convert an FEC-A coded bit stream into an ITA-2 bit stream. 


BAUER 

In: Bitstream 
Out: Bit stream 
Function: 

Convert a BAUER coded bit stream into an ITA-2 bit stream. 


HNG-FEC 

In: Bitstream 
Out: Bit stream 
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Function: 

Convert a HNG-FEC coded bit stream into an ITA-2 bit stream. 

RUM-FEC 

In: Bit stream 
Out: Bit stream 
Function: 

Convert a RUM-FEC coded bit stream into an ITA-2 bit stream. 

ITA-3 (M.342) 

In: Bit stream 
Out: Bit stream 
Function: 

Convert an ITA-3 coded bit stream into an ITA-2 bit stream. 


ITA-5 

In: Bitstream 
Out: Bit stream 
Function: 

Remove the parity bits of an ITA-5 coded bit stream. 

PSK-31 (Varicode) 

In: Bitstream 
Out: Bit stream 
Function: 

Convert a PSK-31 (Varicode) code into an ITA-2 bit stream. 


Source Decoding (Alphabet) 

Latin 

In: Bit stream 

Out: Character stream 

Function: 

Convert a bit stream to Unicode text (Latin). If Transparent display mode is set to No, then special cha- 
racters like carriage return or line feed are treated as control characters and applied to the output window. 
If Transparent display mode is set to Yes, then the special characters are displayed using a correspond- 
ing, descriptive symbol. 

The source code format can be set to ITA-2 or ITA-1. 

Third-shift Greek 

In: Bitstream 

Out: Character stream 

Function: 

Convert a bit stream to Unicode text (Third-shift Greek). If Transparent display mode is set to No, then 
special characters like carriage return or line feed are treated as control characters and applied to the out- 
put window. If Transparent display mode is set to Yes, then the special characters are displayed using a 
corresponding, descriptive symbol. 
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Cyrillic 

In: Bitstream 

Out: Character stream 

Function: 

Convert a bit stream to Unicode text (Cyrillic). If Transparent display mode is set to No, then special 
characters like carriage return or line feed are treated as control characters and applied to the output win- 
dow. If Transparent display mode is set to Yes, then the special characters are displayed using a corres- 
ponding, descriptive symbol. 

Tass-Cyrillic 

In: Bitstream 

Out: Character stream 

Function: 

Convert a bit stream to Unicode text (TASS Cyrillic). If Transparent display mode is set to No, then spe- 
cial characters like carriage return or line feed are treated as control characters and applied to the output 
window. If Transparent display mode is set to Yes, then the special characters are displayed using a cor- 
responding, descriptive symbol. 

Third-shift Cyrillic 

In: Bitstream 

Out: Character stream 

Function: 

Convert a bit stream to Unicode text (Third-shift Cyrillic). If Transparent display mode is set to No, then 
special characters like carriage return or line feed are treated as control characters and applied to the out- 
put window. If Transparent display mode is set to Yes, then the special characters are displayed using a 
corresponding, descriptive symbol. 

Hebrew 

In: Bit stream 

Out: Character stream 

Function: 

Convert a bit stream to Unicode text (Hebrew). If Transparent display mode is set to No, then special 
characters like carriage return or line feed are treated as control characters and applied to the output win- 
dow. If Transparent display mode is set to Yes, then the special characters are displayed using a corres- 
ponding, descriptive symbol. 

Arabic Baghdad-70 

In: Bit stream 

Out: Character stream 

Function: 

Convert a bit stream to Unicode text (Arabic Baghdad-70). If Transparent display mode is set to No, 
then special characters like carriage return or line feed are treated as control characters and applied to the 
output window. If Transparent display mode is set to Yes, then the special characters are displayed us- 
ing a corresponding, descriptive symbol. 

Arabic Baghdad-80 (ATU-80) 

In: Bit stream 

Out: Character stream 

Function: 

Convert a bit stream to Unicode text (Arabic Baghdad-80). If Transparent display mode is set to No, 
then special characters like carriage return or line feed are treated as control characters and applied to the 
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output window. If Transparent display mode is set to Yes, then the special characters are displayed us- 
ing a corresponding, descriptive symbol. 


Bulgarian 

In: Bitstream 

Out: Character stream 

Function: 

Convert a bit stream to Unicode text (Bulgarian). If Transparent display mode is set to No, then special 
characters like carriage return or line feed are treated as control characters and applied to the output win- 
dow. If Transparent display mode is set to Yes, then the special characters are displayed using a corres- 
ponding, descriptive symbol. 


Swedish 

In: Bit stream 

Out: Character stream 

Function: 

Convert a bit stream to Unicode text (Swedish). If Transparent display mode is set to No, then special 
characters like carriage return or line feed are treated as control characters and applied to the output win- 
dow. If the Transparent display mode is set to Yes, then the special characters are displayed, using a 
corresponding, descriptive Symbol. 

Danish-Norwegian 

In: Bit stream 

Out: Character stream 

Function: 

Convert a bit stream to Unicode text (Danish/Norwegian). If Transparent display mode is set to No, then 
special characters like carriage return or line feed are treated as control characters and applied to the out- 
put window. If Transparent display mode is set to Yes, then the special characters are displayed using a 
corresponding, descriptive symbol. 

German 

In: Bit stream 

Out: Character stream 

Function: 

Convert a bit stream to Unicode text (German). If Transparent display mode is set to No, then special 
characters like carriage return or line feed are treated as control characters and applied to the output win- 
dow. If Transparent display mode is set to Yes, then the special characters are displayed using a corres- 
ponding, descriptive symbol. 


French 

In: Bitstream 

Out: Character stream 

Function: 

Convert a bit stream to Unicode text (French). If Transparent display mode is set to No, then special 
characters like carriage return or line feed are treated as control characters and applied to the output win- 
dow. If Transparent display mode is set to Yes, then the special characters are displayed using a corres- 
ponding, descriptive symbol. 


us 

In: Bitstream 

Out: Character stream 

Function: 
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Converts a bit stream to Unicode text (US). If Transparent display mode is set to No, then special cha- 
racters like carriage return or line feed are treated as control characters and applied to the output window. 
If Transparent display mode is set to Yes, then the special characters are displayed using a correspond- 
ing, descriptive symbol. 

ASCII 

In: Bitstream 

Out: Character stream 

Function: 

Convert a bit stream to ASCII text. The user can select between 7 bit ASCII and 8 bit ASCII. 


UNICODE 

In: Bit stream 

Out: Character stream 

Function: 

Convert a bit stream to Unicode text. The user can select between Little- and Big-Endian. 

UTF-7 

In: Bit stream 

Out: Character stream 

Function: 

Convert a bit stream to UTF-7 text. 

UTF-8 

In: Bit stream 

Out: Character stream 

Function: 

Convert a bit stream to UTF-8 text. 

Pager Numeric 

In: Bitstream 

Out: Character stream 

Function: 

Convert a pager (POCSAG) bit stream to numeric characters. 


Analysis Tools 

Symbol Statistics 

In: Bit stream 
Out: Chart 
Function: 

Generate a histogram displaying the statistical distribution of symbols. The number of bits per symbol can 
be adjusted in a field in the upper left corner of the chart. Additionally bits may be shifted right or left us- 
ing the arrow buttons. 
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This chart is only calculated once, i.e., the content does not change, even if the analysis set is recalcu- 
lated. To update histogram values, close the window and then reopen it. 

A right click on the histogram makes additional functionality available. 



Autocorrelation 

In: Bitstream 
Out: Chart 
Function: 

Generate a graphical display of an autocorrelation operation on the input bit stream. 



This chart is only calculated once, i.e., the content does not change, even if the analysis set is recalcu- 
lated. To update graph values, close the window and then reopen it. 

Built-in zoom functions that are available by using mouse clicks. 
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A drag-and-drop operation will select an area for zooming. 

A right click on the display makes additional functionality available. 



If the view has been changed by drag and drop, the original dimensions can be restored by clicking Origi- 
nal Dimensions. 

Signal Duration 

In: Bitstream 
Out: Histogram 
Function: 

Generates a statistical histogram of signal duration. 


Signal Duration 



This chart is only calculated once, i.e., the content does not change, even if the analysis set is recalcu- 
lated. To update histogram values, close the window and then reopen it. 

A drag-and-drop operation will select an area for zooming. 

A right click on the display makes additional functionality available. 



If the view has been changed by drag and drop, the original dimensions can be restored by clicking Origi- 
nal Dimensions. 
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Bit Sync Analysis 

In: Bitstream 

Out: Analysis window 

Function: 

Opens a bit synchronization analysis window. 



Bit Sync Analysis is designed to find the starting position of a frame. For this reason, all bits are dis- 
played in a graphical view with an adjustable number of bits per line; this makes it easier to find periodic 
sequences. 

The settings for Bit Sync Analysis are defined in the Properties window: 

Bits per line define the number of bits per line. 

Bit extraction mode offers a choice between Bit mask and Stream de-interleave modes. Depending 
on the mode selected, either the bit mask or the de-interleaving can be configured. For details of these 
functions, please refer to the descriptions of the Extraction and De-Interleaving Bit Stream functions 
in the Bit Manipulation section of this manual. 

The Layout category controls the appearance of the graphical bit display. 

In the Decoding category, the decoding alphabet is selected. Supported alphabets are ITA2, ITA3, 
CCIR476_5, ASCII (7 Bit) and ASCII (8 Bit). Decoding is only possible if Bit mask is activated. 

The CCIR476_5 and ITA3 alphabets are redundant alphabets allowing a calculation of the number of valid 
frames, which is displayed in the Decoding category. This is an additional help to find the start of a frame 
inside a bit stream. For the other alphabets, a validation is not possible. 

The Navigation category defines the behavior of the four arrow buttons in the bottom area of the dialog 
window. 

Example: 

Open the SITOR example analysis, located in the BitViewTool\Examples folder and select the Import 

IAS Bit stream function in the History Explorer. Open the Analysis Tools in the Toolbox and select 
Bit Sync Analysis. The dialog below will appear: 
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SITOR-A has a block length of 45, so adjust Bits per line to 45 bits. As the alphabet is known, select 
CCIR476_5. The next step is to configure the Bit mask with 21 ones and 24 zeros. After configuration of 
the bit mask, the dialog looks like this: 



As the SITOR alphabet allows validation, the remaining task is to move the selection across the window 
with the navigation arrow buttons and check the percentage of valid frames. The figure below shows a va- 
lid bit block: 
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The decoded text is displayed in the Decoding category. 

Analysis Set Library 


Familiarize yourself with Bit Analysis 

To familiarize you with bit analysis using the rich function and tool set of BitView, it is strongly recom- 
mended to study the working of ready-made Analysis Sets. The library of analysis sets is found here, 

Windows XP and earlier: 

• Documents and Settings\AII Users\Documents \WAVECOM\BitViewTool\Examples 

• Documents and Settings\AII Users\Shared Documents \WAVECOM\BitViewTool\Examples 

Windows Vista: 

• Users\Public\Public Documents\WAVECOM\BitViewTool\Examples 

Custom Library 


Want to Roll Your Own functions? 

The ability to expand BitViewTool with custom developed functions is one of the most powerful features of 
this application. However, before you start rolling your own functions you must have a good grasp of C#, 
object oriented programming and the use of Microsoft Visual Studio and .NET. In addition a solid know- 
ledge of MatLab and the mathematical aspects of communication systems is a prerequisite to benefit from 
these powerful tools. The books listed below may help the programmer to get acquainted with the devel- 
opment tools, 

• Bernhard Sklar, "Digital Communications: Fundamentals and Applications", 2nd Ed., Prentice-Hall, 
2001 

• John Sharp, "Microsoft Visual C# 2005 - Step by Step", Microsoft Press, 2006 

• Ruda Pratap, "Getting Started with MATLAB 7", Oxford 
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The Custom Library Interface supports the integration of third party functions into BitViewTool. Functions 
may be implemented using any .NET language, i.e., C#.NET, VB.NET, J#.NET and C+ + . NET, using the 
.NET Framework 2.0. Custom functions are compiled into individual 32-bit .NET DLLs and executed on op- 
erating systems supported by BitViewTool, including Windows 2000, XP, 2003 Server and Vista. 

As from release 2.1 it is also possible to write mathematical functions in MatLab and integrate them with 
BitViewTool. 

Examples using custom functions are distributed with BitViewTool. The custom library DLL as well as the 
source code can be found in the CustomLib folder of the BitViewTool. The projects (solutions) provided 
were created using MS Visual Studio .NET 2005 with .NET Framework 2.0. 

The CustomLib folder is created during installation. 

On Windows XP and older: 



On Windows Vista: 



Four subfolders are also created: 

CustomLibFunction 

A .NET custom library example. The output of this project is CustomLibFunction.dll, which can be used 
with BitViewTool. 

BVCustLibMatlab 

Example project for a wrapper for a MatLab custom function. The output of this project is BVCustLibMat- 
lab.dll. 

MatlabFunctionExample 

Example project for MatLab. This is an example that shows how to compile MatLab code into .NET code. 
The output of this project is MatlabFunction.dll and MatlabFunction.ctf. Together with BVCustLibMat- 
lab. dll, these files build a MatLab custom function that can be used with BitViewTool. 
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VisualStudio Templates 

Templates for Microsoft Visual Studio are provided to create new custom function projects. Please read the 
Readme.txt file that is included in this subfolder for more information. 


Adding a Custom Function 

Adding a new custom function is simply done by adding its DLL to the CustomLib folder. 

Windows XP and older: 

• Documents and Settings\AII Users\Documents\WAVECOM\BitViewTool\CustomLib 

• Documents and Settings\AII Users\Shared Documents\WAVECOM\BitViewTool\CustomLib 

Windows Vista: 

• Users\Public\Public Documents\WAVECOM\BitViewTool\ CustomLib 

BitViewTool automatically adds the function to the Custom Library list in the Toolbox after launch. Alterna- 
tively, if BitViewTool is already running, the custom function may be added to the list using the Import 
Custom Library item in the Tools menu. 

Please be aware that the Custom Library button will not appear in the Toolbox if a custom function is not 
provided. 



The icon file for the custom function is named CustomLibFunction.bmp and can be customized using the 
built-in editor in Visual Studio. By compiling the custom function, the icon is integrated into the custom lib 
DLL. 


Constraints 

All BitViewTool functions belong to one of three groups: 

• Source functions, which have no input. 

• Sink functions, which have no output. 

• General functions, which have both input and output, and where the input type is BitArray and the 
output type may be BitArray or string. 

Presently custom functions are limited to be general functions with the input and output type is BitArray. 


Important Notes 

When creating custom functions, certain rules must be observed. Please refer to the source code tem- 
plates and examples for more details. 
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The following source code elements (names) are mandatory and may not be modified: 

• namespace CustomLib 

• public string FunctionName 

• public string Comment 

• public BitArray Calculate(BitArray buf) 

Property categories and additional properties may be defined without limitations. 


Steps to Write a Custom Function in C# .NET 

• Open the CustomLibFunction example or create a new project based on the BVCustLibFunc tem- 
plate 

• Change assembly and class name according to your needs 

• Modify the properties and expand the calculate function with your code 

• Compile the project and copy the output DLL to the CustomLib folder (see above) 


Steps to Write a Custom Function with MatLab 



^Solution Explorer ;2v Class View 

Properties ▼ ? X 


MatlabFunction Reference Properties 



MatlabFunction 


Aliases 

global 

Copy Local 

True 

Culture 


Description 


File Type 

Assembly 

Identity 

MatlabFunction 

Path 

<Cji\Docunnents and 5ettings\All L 

Resolved 

True 

Runtime Version 

v2. 0.50727 

Specific Version 

False 

Strong Name 

False 


Version 2.0.2957.21875 


• Open the MatlabFunctionExample project (MatlabFunction. prj) in MatLab 

• Change the . M-File according to your needs 

• Compile the MatLab code. If the compilation process was successful, there will be two new files in 
the .\MatlabFunction\distrib subfolder, MatlabFuntion.dll and MatlabFunction. ctf 

• Open the BVCustLibMatlab example or create a new project based on the BVCustLibMatlab tem- 
plate 

• Change assembly and class name according to your needs 

• Set a reference to the MatlabFunction.dll in the \distrib subfolder. Thus, the BVCustLibMatlab class 
will know where to find the MatLab DLL 

• Compile the BVCustLibMatlab project and copy all the files in the output directory to the Custom- 
Lib folder 
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Source Code Template / Example (C# .NET) 


CustomLibFunction.es 


// 

// 

// 

// 

// 

// 

// 

// 

// 

// 

// 


File 

Author 

Date 

Description 


CustomLibFunction . cs 
WAVECOM Elektronik AG 
February 2008 

Template/example for a custom defined library function. 
Important note : 

In the project settings the "Assembly Name" must be 
equal to the "Default Namespace". 


#region using references 


using System; 

using System. Collections; 

using System. Text; 

using System . ComponentModel ; 

using CustomLibFunction . Properties ; 

#endregion 

namespace CustomLib // Mandatory! Do not change this name. 

{ 

III <summary> 

III </summary> 

[Serializable] 

[DefaultProperty ( "FunctionName" ) ] // adjust string if necessary, it points to a property 

below 

public class CustomLibFunction 

{ 

#region Constant fields 


private class PropertyCategory 

{ 

// these are the categories in the BitViewTool property grid (Parameter Window) 

public const string Information = "Information"; 

public const string Counter = "Counter"; 

public const string Configuration = "Configuration"; 

public const string Calculation = "Calculation"; 


ries 


// do not change these names, they are used to distinguish the different catego- 
// when any change in the parameters happens 


private const int MAX_SIZE = 500000; // do not modify this value 

#endregion 

#region Fields 

// generate a new BitArray for calculation, it will be returned to the calling func- 
tion 

private BitArray outbox = new BitArray (MAX_SIZE) ; 

#endregion 

#region Mandatory Properties 

private string functionName = "CustomLibFunction"; 

III <summary> 

III Mandatory! Do not delete this property! The string "CustomLibFunction" may be 
modified . 

Ill This will be the name of the Function in the BitViewTool History explorer and 

ToolBox 

III </summary> 

[Category (PropertyCategory. Information) ] 

[Description ( "Description of CustomLibFunction goes here.\n" + 
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"Here: example of a custom defined library function. Inverts all the 

input bits . \n" ) ] 

[DisplayName ( "Function Name")] 
public string FunctionName 
{ 

get 

{ 

return (functionName) ; 

} 

} 


private string comment = string . Empty; 

III <summary> 

III Mandatory! Do not modify this property! 

Ill </summary> 

[Category (PropertyCategory . Information) ] 

[Description ( "My comments.")] 

[DefaultValue ("") ] 
public string Comment 
{ 

get 

{ 

return comment; 

} 

set 

{ 

comment = value; 

} 

} 

private static System. Drawing . Image iconlmage = Resources . CustomLibFunction; 

III <summary> 

III If available, you can specify a custom image displayed on the function button 
III in the BitView toolbox. The image must be 16x16 pixel. The bitmap file must be 
III imported into the CustomLibFunction resources, so that it can be refered to it as 
shown above ! 

Ill Currently the image is the .bmp file 'CustomFunction.bmp'. It is part of this so- 
lution, it can be 

III seen in the Solution Explorer Window and it can be modified. 

Ill If there is no image available, remove all private and public fields, i.e. iconl- 
mage and Iconlmage, 

III iconTransparentColor and IconTransparentColor 

III below. A default icon image is then added by the BitViewTool main application. 

Ill </summary> 

[Category (PropertyCategory. Information) ] 

[Description ( "Icon bitmap for Toolbox Button and History Explorer")] 

[Browsable (false) ] 

public static System. Drawing . Image Iconlmage 

{ 

get 

{ 

return iconlmage; 

} 

} 

private static System. Drawing . Color iconTransparentColor = Sys- 

tem. Drawing .Color . White; 

III <summary> 

III If available, you can specify a custom image display on the function button 
III in the toolbox. The image must be 16x16 pixel, the transparent color must 
III be specified here 
III </summary> 

[Category (PropertyCategory. Information) ] 

[Description ( "Icon bitmap transparent color")] 

[Browsable (false) ] 

public static System. Drawing . Color IconTransparentColor 

{ 

get 

{ 

return iconTransparentColor; 

} 

} 

#endregion 

#region Optional Properties 
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private string dummyCalculation = string . Empty; 

III <summary> 

III Optional result form this function! DummyCalculation. Put all results into this 

category 

III </summary> 

[Category (PropertyCategory . Calculation) ] 

[Description ( "Description of DummyCalculation goes here. Here: number of output 

bits . " ) ] 

[DisplayName ( "Dummy Calc.")] 
public string DummyCalculation 
{ 

get 

{ 

return (dummyCalculation) ; 

} 

} 


// add more Calculation properties here 

/ / ... 


private int dummyParameter = 0; 

III <summary> 

III Optional! Dummy Parameter. Put all input parameters for the calculation into this 

category 

III </summary> 

[Category (PropertyCategory. Configuration) ] 

[Description ( "Description of DummyParameter goes here. Here: not used.")] 

[DefaultValue (0) ] 

[DisplayName ( "Dummy Parameter") ] 
public int DummyParameter 
{ 

get 

{ 

return (dummyParameter) ; 

} 

set 

{ 

dummyParameter = value; 

} 

} 


// add more Configuration properties here 

// ... 


#endregion 

#region Constructor 
III <summary> 

III Constructor 

III </summary> 

public CustomLibFunction ( ) 

{ 

// add initialisation code if necessary 

} 

#endregion 

#region calculation function 
III <summary> 

III II THE calculate function. Do not change name or parameter! This function will be 
searched for 

III by reflection and called for execution, when this library is added to an analy- 
sis . 

Ill </summary> 

public BitArray Calculate (BitArray buf ) 

{ 

if (buf == null) 

return (null) ; 

if (buf. Count <= 0) 

{ 

outbox . Length = 0; 
return (outbox) ; 
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} 


// 

// any calculation goes here 

// 

outbox = (BitArray) buf . Clone () ; 
outbox . Not ( ) ; 

this . dummyCalculation = outbox . Count . ToString () ; // any calculation results of 

interest will be reflected in the property grid 

return (outbox); // must return the result 


} 

#endregion 



Source Code Template / Example (C# .NET for MatLab) 

BVCustLibMatlab.es 


//- 



// 

File 

BVCustLibMatlab . cs 

// 

Author 

WAVECOM Elektronik AG 

// 

Date 

February 2008 

// 

// 

Description 

Template/example for a custom defined library function. 

// 


Important note : 

// 


In the project settings the "Assembly Name" must be 

// 

// 


equal to the "Default Namespace". 

//- 




#region using references 
using System; 

using System. Windows . Forms; 

using System. Collections; 

using System. Text; 

using System . ComponentModel ; 

using System. Diagnostics; 

using BVCustLibMatlab . Properties ; 

// if working with MatLab .net DLLs 
using MathWorks . MATLAB . NET . Utility; 
using MathWorks .MATLAB.NET .Arrays; 

// reference to the MatLab dll 
using MatlabFunction; 

#endregion 

namespace CustomLib // Mandatory! Do not change this name. 

{ 

III <summary> 

III </summary> 

[Serializable] 

[DefaultProperty ( "FunctionName" ) ] // adjust string if necessary, it points to a property 

below 

public class BVCustLibMatlab 

{ 

#region Constant fields 

private class PropertyCategory 

{ 

// these are the categories in the BitViewTool property grid (Parameter Window) 

public const string Information = "Information"; 

public const string Counter = "Counter"; 

public const string Configuration = "Configuration"; 

public const string Calculation = "Calculation"; 
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// do not change these names, they are used to distinguish the different catego- 
ries 

/ / when any change in the parameters happens 

} 

private const int MAX_SIZE = 500000; // do not modify this value, it specifies maxi- 
mum number of bits processed by BitViewTool 

#endregion 

#region Fields 

// generate a new BitArray for calculation, it will be returned to the calling func- 
tion 

private BitArray outbox = new BitArray (MAX_S I ZE) ; 

#endregion 

#region Mandatory Properties 

private string functionName = "Test CustomLib MatLab"; 

III <summary> 

III Mandatory! Do not delete this property! The string "BVCustLibMatlab" may be mod- 
ified . 

Ill This will be the name of the Function in the BitViewTool History explorer and 

ToolBox 

III </summary> 

[Category (PropertyCategory . Information) ] 

[Description ( "Description of Test CustomLib MatLab goes here.\n" + 

"Here: example of a custom defined library function. Inverts all the 

input bits.\n" + 

"Inversion is performed by a MatLab function encapsulated in a .net 

dll assembly.")] 

[DisplayName ( "Function Name")] 
public string FunctionName 


return (functionName) ; 


private string comment = string . Empty; 

III <summary> 

III Mandatory! Do not modify this property! 
Ill </summary> 

[Category (PropertyCategory. Information) ] 
[Description ( "My comments.")] 

[DefaultValue ("") ] 
public string Comment 


return comment; 


comment = value; 


private static System. Drawing . Image iconlmage = Resources . matlab; 

III <summary> 

III If available, you can specify a custom image displayed on the function button 

III in the BitView toolbox. The image must be 16x16 pixel. The bitmap file must be 

III imported into the CustomLibFunction resources, so that it can be refered to it as 
shown above ! 

Ill Currently the image is the .bmp file 'CustomFunction.bmp'. It is part of this so- 
lution, it can be 

III seen in the Solution Explorer Window and it can be modified. 

Ill If there is no image available, remove all private and public fields, i.e. iconl- 
mage and Iconlmage, 

III iconTransparentColor and IconTransparentColor 

III below. A default icon image is then added by the BitViewTool main application. 

Ill </summary> 

[Category (PropertyCategory. Information) ] 
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[Description ( "Icon bitmap for Toolbox Button and History Explorer")] 

[Browsable (false) ] 

public static System. Drawing . Image Iconlmage 

{ 

get 

{ 

return iconlmage; 

} 

} 

private static System. Drawing . Color iconTransparentColor = Sys- 

tem. Drawing . Color . FromArgb (224 , 223, 227); 

III <summary> 

III If available, you can specify a custom image display on the function button 
III in the toolbox. The image must be 16x16 pixel, the transparent color must 
III be specified here 
III </summary> 

[Category (PropertyCategory . Information) ] 

[Description ( "Icon bitmap transparent color")] 

[Browsable (false) ] 

public static System. Drawing . Color IconTransparentColor 

{ 

get 

{ 

return iconTransparentColor; 

} 

} 

#endregion 

#region Optional Properties 

// Input Parameter for calculation function 

private int inparl = 13; // set a reasonable default value 
III <summary> 

III optional parameter for calculation, put this into the Configuration category 
III </summary> 

[Category (PropertyCategory . Configuration) ] 

[Description ( "Description of Input 1 goes here")] 

[DefaultValue (13) ] // set a reasonable default value 

[DisplayName ( "Input 1")] 
public int Inparl 
{ 

get 

{ 

return inparl; 

} 

set 

{ 

inparl = value; 

} 

} 


private int inpar2 =5; // set a reasonable default value 
III <summary> 

III optional parameter for calculation, put this into the Configuration category 
III </summary> 

[Category (PropertyCategory . Configuration) ] 

[Description ( "Description of Input 2 goes here")] 

[DefaultValue (5) ] // set a reasonable default value 

[DisplayName ( "Input 2")] 
public int Inpar2 
{ 

get 

{ 

return inpar2; 

} 

set 

{ 

inpar2 = value; 

} 

} 


// add more Configuration properties here 


64 • Custom Library 


BitView Manual V2.3.00 WAVECOM W-BV 





// 


// results from calculation function 

private int outparl = 0; 

III <summary> 

III Optional result form this function! Put all results into the calculation category 
III </summary> 

[Category (PropertyCategory . Calculation) ] 

[Description ( "Description of Output 1 goes here.")] 

[DisplayName ( "Output 1")] 
public int Outparl 
{ 

get 

{ 

return outparl; 

} 

} 


private int outpar2 = 0; 

III <summary> 

III Optional result form this function! Put all results into the calculation category 
III </summary> 

[Category (PropertyCategory . Calculation) ] 

[Description ( "Description of Output 2 goes here.")] 

[DisplayName ( "Output 2")] 
public int Outpar2 
{ 

get 

{ 

return outpar2; 

} 

} 

private int outpar3 = 0; 

III <summary> 

III Optional result form this function! Put all results into the calculation category 
III </summary> 

[Category (PropertyCategory. Calculation) ] 

[Description ( "Description of Output 3 goes here.")] 

[DisplayName ( "Output 3")] 
public int Outpar3 
{ 

get 

{ 

return outpar3; 

} 

} 

private int outpar4 = 0; 

III <summary> 

III Optional result form this function! Put all results into the calculation category 
III </summary> 

[Category (PropertyCategory. Calculation) ] 

[Description ( "Description of Output 4 goes here.")] 

[DisplayName ( "Output 4")] 
public int Outpar4 
{ 

get 

{ 

return outpar4; 

} 

} 


private string outpar5 = string . Empty; 

III <summary> 

III Optional result form this function! Put all results into this category 
III </summary> 

[Category (PropertyCategory . Calculation) ] 

[Description ( "Description of Output 5 (string) goes here.")] 

[DisplayName ( "Output 5")] 
public string Outpar5 
{ 


BitView Manual V2.3.00 WAVECOM W-BV 


Custom Library • 65 





get 

{ 

return (outpar5) ; 

} 

} 


// add more Calculation properties here 

// ... 

#endregion 

#region Constructor 
III <summary> 

III Constructor 

III </summary> 

public BVCustLibMatlab ( ) 

{ 

// add initialisation code if necessary 

} 

#endregion 

#region calculation function 
III <summary> 

III II THE calculate function. Do not change name or parameter! This function will be 
searched for 

III by reflection and called for execution, when this library is added to an analy- 
sis . 

Ill </summary> 

public BitArray Calculate (BitArray buf ) 

{ 

if (buf == null) 

return (null) ; 

if (buf. Count <= 0) 

{ 

outbox . Length = 0; 
return (outbox) ; 

} 

// 

// any calculation goes here 

// 

try // catch any exception from matlab dll. If calling the matlab function 

fails, we do not crash the app 

{ 

// Generate data arrays for MatLab function. 

// Data input for matlab function is derived from buf, which is type of Bi- 
tArray 

// MatLab has not a compatible data type, so we have to convert BitArray buf 
// into the MatLab default numeric type double 0.0 and 1.0 

// new instance of a MatLab numeric array with a size of [buf . Length, 1 ] 
MWNumericArray data = new MWNumericArray (MWArrayComplexity . Real , MWNumeric- 
Type. Double, new int [ ] { buf. Length, 1 §); 

// Initialize data from BitArray buf 

// MatLab index range is from 1 . . . n, in C# it is from 0 ... (n-1) 

for (int idx = 1; idx <= buf. Length; idx++) 

{ 

data [idx, 1] = buf [idx - 1] ? 1.0 : 0.0; 

} 

// data output from matlab function is an Array of arguments 
MWArray [ ] argsOut = null; 

// prepare for calling the MatLab function, create an instance of the MatLab 

function class 

// generated by the MatLab deploytool, use Intellisense in visual studio, 

then you see 

// the list of classes found up to now in this project. Our example is 
// MatLab function called ' MatlabFunction ' in the .m File with the same name. 
// Here is the complete listing of the MatLab .m File: 

/* 
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function [y, outparl, outpar2, outpar3, outpar4, outpar5] 
x, inparl, inpar2 ) 


= MatlabFunction ( 


Example of a function to be called from .Net environment, especially from 
a BitViewTool CustomLib function. This function declares different input 
and output parameters, to demonstrate how to access these parameters from 
a .Net environment. 


Inputs : 


x : should be a [n,l] input array containing the bit stream from the 

BitViewTool, the expected values must be 0 and 1 
inparl, inpar2 : these are parameters to control the function's behaviour 

Outputs : 


y : should be a [k,l] output array containing the bit stream as an 

output from this function, the type of y should be double or logi- 

The values must be 0.0 and 1.0 if double. 

outparl, outpar2, outpar3, outpat4, outpar5 : these are additional calcula- 

results from this function of type scalar or string depending on the 
function's behaviour. outpar5 is of type char array 


% After this function is debugged and tested, the MatLab deploytool has to be 
% started with 'deploytool' in the Command Window 

% In the deploytool create a new .net project, project type is .NET 
% Component, enter a Component name, in the project settings under .NET set 

the 

% the Microsoft Framework to Version 2.0, the Assembly type to private. 

% Then push the Build Project button in the Deployment toolbar. 

% When finished copy the .dll and . ctf files from the function's 
% pro j ect\distrib directory to the BitViewTool customlib directory 
% C:\Documents and Settings\All Us- 

er s\ Document s\WAVECOM\BitViewTool\CustomLib 

% Next step is to create a new WAVECOM CustomLib function from the template 
% found in the new project wizzard in Visual Studio. 

% Add a the reference in the Solution Explorer to the .dll just copied to to 
% CustomLib directory. Add a reference in the C# CustomLib source under the 
% 'using' region, the namespace to be used is the same used in the solution 
% explorer. 


outparl = nargin; % for example : outparl returns number of input function 

arguments 

[m, n] = size ( x ) ; % for example : outpar2 returns length of input array 

x, i.e. number of rows 

outpar2 = m; 

outpar3 = n; % number of columns, should be 1 in our example 

outpar4 = inparl * inpar2; % example of calculation for outpar4 


y is inverse (x) 


y = ~x; % this is the only calculation for the input data, outpt 

% and converts y to type ' logical ' ! ! ! ! 

if (n ~= 1) 

outpar5 = 'Function error: input data dimension [m,n] with n ~= 1'; 

else 

outpar5 = 'Function called successfully'; 

end 


// we can now see 3 Input parameters and 6 output parameters 

// x is the input data column vector, type is double 

// y is the returned column vector, type can be double or logical, 
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// all other parameters are scalars, expected 
// to be of type double, outpar5 is of type string 
// Use Intellisense to see all available classes 

// the matlab deploytool generates a class by using the MatLab function name 
// with 'class' appended: 

MatlabFunctionclass MatlabFunc = new MatlabFunctionclass ( ) ; // new instance 

of MatLab function 

// now call this function, with 6 output parameters : y and outpar 1...5 
argsOut = MatlabFunc . MatlabFunction ( 6, data, (double) Inparl , (double) Inpar2 ) ; 

// now get all results from argsOut, its an array of numeric/char arrays 
// the first entry is our bit array result, can be of type numeric (double ) or 


logical , 


// depending on the matlab function internal code 


if ( (argsOut [0] . IsNumericArray) && (argsOut [ 0 ]. Numberof Dimensions == 2)) 

// if numeric and number of dimension exactly 2 

{ 

MWNumericArray numericBits = (MWNumericArray) argsOut [ 0 ] ; // cast to 

MWNumericArray 

MWNumericType numericType = numericBits .NumericType; // get the 

numeric type, can be double, float, int, etc..., this has to be checked 

Array numericBitsArray = numericBits . ToVector (MWArrayComponent . Real ) ; 

// must be anything but not complex ! ! ! 

int length; 


double array 


switch (numericType) // check types, we expect double 

{ 

case MWNumericType . Double : 

doublet] doubleArray = (double []) numericBitsArray; // cast to 

length = doubleArray . Length; 
if (length > MAX_SIZE) 

{ 

length = MAX_SIZE; 


have MAX SIZE 


have MAX SIZE 


// convert now result to type of BitArray 
for (int i = 0 ; i < length; ++i) 

{ 

outbox [i] = (doubleArray [ i ] ==0.0) ? false : true; 

} 

outbox . Length = length; // set length explicitely, otherwise we 


case MWNumericType . Int32 : 

Int32[] int32Array = ( Int32 []) numericBitsArray; // cast to int32 

length = int32Array . Length; 
if (length > MAX_SIZE) 

{ 

length = MAX_SIZE; 

} 

// convert now result to type of BitArray 
for (int i = 0; i < length; ++i) 

{ 

outbox [i] = (int32Array [i] == 0) ? false : true; 

} 

outbox . Length = length; // set length explicitely, otherwise we 


case MWNumericType . Inti 6 : 

Intl6[] intl6Array = ( Inti 6 []) numericBitsArray; // cast to intl6 

length = inti 6Array . Length; 
if (length > MAX_SIZE) 

{ 

length = MAX_SIZE; 

} 

// convert now result to type of BitArray 
for (int i = 0; i < length; ++i) 

{ 

outbox [i] = (intl6Array [i] == 0) ? false : true; 
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have MAX SIZE ! ! 


array 


have MAX SIZE ! ! 


outbox . Length = length; // set length explicitely, otherwise we 
break; 

case MWNumericType . Int8 : 

Byte [ ] byteArray = (Byte [ ] ) numericBitsArray; // cast to intl6 

length = byteArray . Length; 
if (length > MAX_SIZE) 

{ 

length = MAX_SIZE; 

} 

// convert now result to type of BitArray 
for (int i = 0; i < length; ++i) 

{ 

outbox [i] = (byteArray [ i ] == 0) ? false : true; 

} 

outbox . Length = length; // set length explicitely, otherwise we 
break; 


tionName) ; 


default: // other numeric types not supported 

throw new ApplicationException ( "Bad type returned from " + Func- 


else if ( (argsOut [ 0 ] . IsLogicalArray) && (argsOut [ 0 ]. Numberof Dimensions == 2)) 
// if logical and number of dimension exactly 2 
{ 

MWLogicalArray logicalBits = (MWLogicalArray) argsOut [ 0 ] ; // cast 

to MWLogicalArray 


bool[] boolOutputArray; 

boolOutputArray = logicalBits . ToVector () ; 

array in .net 

outbox = new BitArray (boolOutputArray) ; 
tArray for use with BitViewTool 


// convert all to a bool 
// then initialize a Bi- 


else 


throw new ApplicationException ( "Bad type returned from " + FunctionName); 

} 

// now get other results, we do not check types again, but you should do that 

outparl = (int) (MWNumericArray) argsOut [ 1 ] ; 

outpar2 = (int) (MWNumericArray) argsOut [2 ] ; 

outpar3 = (int) (MWNumericArray) argsOut [ 3 ] ; 

outpar4 = (int) (MWNumericArray) argsOut [ 4 ] ; 

outpar5 = ( (MWCharArray) argsOut [ 5 ]). ToString () ; 

} 

catch (Exception ex) 

{ 

MessageBox . Show (ex . Message . ToString () , "Errors in " + FunctionName); 
outbox . Length = 0; 

} 


return (outbox) ; 


} 

#endregion 



Source Code Template / Example (MatLab) 
MatlabFunction.m 

function [y, outparl, outpar2, outpar3, outpar4, outpar5] = MatlabFunction ( x, inparl, inpar2 

) 

% Example of a function to be called from .Net environment, especially from 
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% a BitViewTool CustomLib function. This function declares different input 
% and output parameters, to demonstrate how to access these parameters from 
% a .Net environment. 

% Inputs : 


% x : should be a [n,l] input array containing the bit stream from the 

% BitViewTool, the expected values must be 0 and 1 

% inparl, inpar2 : these are parameters to control the function's behaviour 
% Outputs : 


% y : should be a [k,l] output array containing the bit stream as an 

% output from this function, the type of y should be double or logical. 

% The values must be 0.0 and 1.0 if double. 

% outparl, outpar2, outpar3, outpat4, outpar5 : these are additional calculation 
% results from this function of type scalar or string depending on the 
% function's behaviour. outpar5 is of type char array 


% After this function is debugged and tested, the MatLab deploytool has to be 
% started with 'deploytool' in the Command Window 

% In the deploytool create a new .net project, project type is .NET 
% Component, enter a Component name, in the project settings under .NET set the 
% the Microsoft Framework to Version 2.0, the Assembly type to private. 

% Then push the Build Project button in the Deployment toolbar. 

% When finished copy the .dll and . ctf files from the function's 
% pro j ect\distrib directory to the BitViewTool customlib directory 
% C:\Documents and Settings\All Users\Documents\WAVECOM\BitViewTool\CustomLib 

% Next step is to create a new WAVECOM CustomLib function from the template 
% found in the new project wizzard in Visual Studio. 

% Add a the reference in the Solution Explorer to the .dll just copied to to 
% CustomLib directory. Add a reference in the C# CustomLib source under the 
% 'using' region, the namespace to be used is the same used in the solution 
% explorer. 


outparl = nargin; % for example : outparl returns number of input function arguments 

[m, n] = size ( x ); % for example : outpar2 returns length of input array x, i.e. number of 

rows 

outpar2 = m; 

outpar3 = n; % number of columns, should be 1 in our example 

outpar4 = inparl * inpar2; % example of calculation for outpar4 

y = ~x; % this is the only calculation for the input data, output y is inverse (x) 

% this converts y to type 'logical' ! ! ! ! 

if (n ~= 1) 

outpar5 = 'Function error: input data dimension [m,n] with n ~= 1'; 

else 

outpar5 = 'Function called successfully'; 

end 


Appendix 
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CodeMeter and CmStick 

Important: For current and detailed information consult the CodeMeter help files. 


CodeMeter Control Center 

When the CodeMeter has been installed the CodeMeter Control Center may be opened by clicking the Co- 
deMeter icon in the Windows system tray. 

The Control Center offers several configuration options via its menu bar and its three tabs in addition to 
basic information regarding the installation. 

The tabs cover the areas listed below 

• Hardware 

• Events 

• Licensing 

CodeMeter Hardware 



Hardware Page 

Remarks 

WebAdmin 

Starts the CodeMeter WebAdministrator in your Internet standard browser 

Eject 

Used to safely remove (a) CmStick(s) 

Change Name 

Use this button to change the name of the selected CmStick. 

Just click the button "Change Name" and enter the new name into the field in the 
"Change Name" window 

Change Password 

Use this button to change the current CmStick password. 

If you should have forgotten your CmStick password, you can use your CodeMeter 
Master-Password to create a new CmStick password 

Firmware Update 

Use this button to update the firmware of the CmStick to the current version. 
To execute the firmware update an Internet connection is required. 
Do not remove your CmStick during the CodeMeter firmware update. This can cause 
serious damage to the CmStick 
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Code Meter Events 



Events Page 

Remarks 

WebAdmin 

Starts the CodeMeter WebAdministrator in your Internet standard browser 

Events 

The Event window contains general information on: 

• The number of the connected CmSticks detected 

• The number of available CmStick entries 

• The number of Firm Items 

• All access to the CodeMeter Runtime Server 


CodeMeter Licensing 



Licensing Page 

Remarks 

WebAdmin 

Starts the CodeMeter WebAdministrator in your Internet standard browser 

CmStick 

Select the desired CmStick by selecting its serial number 

Create Context 

Use this option to create a Remote Context file for the selected CmStick 

Execute Update 

Use this option to write the data from a Remote Update file into the selected 
CmStick. Further information can be found in the Field Activation Services (CmFAS) 
page of the CodeMeter help file 


CodeMeter File 


(5 CodeMeter Control Center 

Process 

View Help 

^ WebAdmin 

Ctrl+W 

V Logging 

Ctrl+L 

O Quit 

Ctrl+Q 


File Menu 

Remarks 

WebAdmin 

Starts the CodeMeter WebAdministrator in your Internet standard browser 

Logging 

Activate/deactivate the logging process. If activated CodeMeter will automatically 
create a logging file in the CodeMeter installation folder (default[windows]: 
[..\ProgramFiles\CodeMeter\logs]) 
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Quit 

Closes the CodeMeter Control Center window without stopping the CodeMeter Run- 


time Server process 


CodeMeter Process 


CodeMeter Control Center 


View Help 
M |-> Eject CmSticks 
j 2S= Defragment License Memory 
3 Update Time Certificate 


j ^ Start CodeMeter Service 

j ^ Stop CodeMeter Service 


Ctrl+Alt+Q 

Ctrl+Alt+D 


Process Menu 

Remarks 

Eject CmSticks 

Used to safely remove (a) CmStick(s) 

Defragment License 

Memory 

Defragment the memory part in the CodeMeter Chip (affects selected 
CmStick) 

Update Time Certificate 

Performs a Certified Time update for the selected CmStick 

Start CodeMeter Service 

Starts the CodeMeter Runtime Server service/daemon 

Stop CodeMeter Service 

Stops the CodeMeter Runtime Server service/daemon 


CodeMeter View 


Control Center 

~~ | Help 

Hide Window 

Ctrl+M 

Refresh 

Ctrl+R 

Zoom In 

Ctrl++ 

c Zoom Out 

Ctrl+- 

i Copy Event Content 

Ctrl+C 

( Q Clear Event Window 

5 (h) List All Open Handles 

Alt+C 

; 3) Show All Available Entries 

Alt+E 

j 3) Show All Connected CmSticks 

Alt+S 


View Menu 

Remarks 

Show all Connected 

CmSticks 

Prints a list of all connected CmSticks 

Hide Window 

Hides the CodeMeter Control Center 

Show All Available Entries 

Prints a list of all available CmStick entries 

List All Open Handles 

Prints a list of all currently opened and used CodeMeter handles. This in- 
formation is useful for developers 

Clear Event Windows 

Clear all entries in the event window 

Copy Event Contents 

Copy the contents of the event window 

Zoom In 

Increases the font size of the event window content 

Zoom Out 

Decreases the font size of the event window content 
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CodeMeter Web Admin 

CodeMeter WebAdmin Home 



The home page displays general information about your computer and the CodeMeter WebAdministrator. 
By pressing the button with the DNS name of your PC, the server selection pop-up window will appear. 



By using the drop-down menu, it is possible to select a different CodeMeter Server. 

CodeMeter WebAdmin Content 

The Content page is split into four subsections: 

• CmStick 

• Licenses 

• User Data 

• Backup/ Restore 
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CodeMeter WebAdmin 


Home rTfffflfnl Server Configuration Diagnosis Info 


CmStick Licenses User Data Backup/Restore 



CmStick: 1 1-1146437 

Name: Rolf Demol 

Hardware: CmStick 1.13.000 

First Device: D: (No Flash) 

Status: □Disabled 

Enabled until Unplugged 
^Enabled 

Certified Time: 2008-07-21 15:32:19 | Update | 

Box Time: 2008-07-21 16:27:47 

System Time: 2008-07-21 16:31:59 
Free Memory: 89 % (58.192 Bytes) | Defragment | 


The CmStick page offers different CmStick management options. 


Content CmStick 

Remarks 

CmStick 

You can select a CmStick via the drop-down menu by choosing its serial number 

Name 

Shows the name for the selected CmStick 

Hardware 

Shows the hardware version of the selected CmStick 

First Device 

Shows the drive letter and the size of the first CodeMeter partition, if a CmStick/M 
(CmStick with flash memory) is connected 

Status 

Shows the current status of the selected CmStick. 

You can change the status of your CmStick by using the CodeMeter Control Center 

Certified Time 

Displays the current internal Certified Time of the selected CmStick. 

You can get a Certified Time update from the defined CodeMeter Time Server by 
clicking on the "Update" button 

Box Time 

Shows the Box Time (internal time) of your CmStick 

System Time 

Displays the selected CmStick's internal clock time 

Free Memory 

Displays the selected CmStick's available memory. To defragment the CmStick 
memory, click the "Defragment" button 


CodeMeter WebAdmin 0^ 


Home nEffTTm Server Configuration Diagnosis Info Help 


CmStick Licenses User Data Backup/Restore 

CmStick: [1-1146437 


100003 1 Bundling Articles 

Product Code 

Name 

Unit Counter 

Expiration Time 

Activation Time 

License Quantity 

1 

SecuriKey Lite 

n/a 

n/a 

n/a 

1 



100787 | WAVECOM ELEKTRONIK AG 


Product Code 

Name 

Unit Counter 

Expiration Time 

Activation Time 

License Quantity 

1 

Standard Modes 

n/a 

n/a 

n/a 

1 

20 

SAT Modes 

n/a 

n/a 

n/a 

1 

30 

Classifier 

n/a 

n/a 

n/a 

1 

80 

W-BV 

n/a 

n/a 

n/a 

1 

100 

W-CODE 

n/a 

n/a 

n/a 

2 


The Licenses page shows all licenses (Firm Items) contained in the selected CmStick. Beneath each Firm 
Item, which is characterized by its Firm Code and "Name", a list of all corresponding Product Codes is dis- 
played. 

To get an overview of all stored products for any Firm Item, just click on the Firm Code entry. 

For detailed information about a Product Item click on the Product Code entry in the Product Item field 
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Content License 

Remarks 

Product Code 

Shows the Product Code for the Product Item 

Name 

Displays the Product Item Text, normally the name of the product 

Unit Counter 

Displays (if available) the remaining credits for this product 

Expiration Time 

Displays the Expiration Time of the product, if it is available 

Activation Time 

Displays the Activation Time of the product, if it is available 

License Quantity 

Displays the number of licenses that are available for this product 




CodeMeter WebAdmin 

O - 


| Content | 


CmStick Licenses User Data Backup/Restore 



CmStick: 

1 1-1146437 



0 | User Data 

ProductCode Name 

Unit Counter 

Expiration Time 

Activation Time 

License Quantity 

0 

n/a 

n/a 

n/a 

1 

1000 

n/a 

n/a 

n/a 

1 


The User Data page shows detailed information about the Firm Code 0 (Implicit Firm Item). 

The Implicit Firm Item or the Firm Code 0 is "The user's own Firm Code". Every time a program wants to 
create a new entry into this Firm Code, CodeMeter asks for the CmStick password. CodeMeter will only al- 
low the program to create a new entry or to change data if the password is correctly entered. 

The User Data is saved automatically and can be restored if needed. 

Further information about the backup and restore functionality can be found on the Backup/ Restore 
page. 

The table structure is the same as for the "Content License" table. 

CodeMeter WebAdmin C M 


Home Server Configuration Diagnosis Info Help 


CmStick Licenses User Data Backup/Restore 

CmStick: 1 1-1146437 jj 



For information how to restore the license data 
inside a Firm Code not equal 0, contact our Support 


On the Backup/ Restore page, you can create CmStick backups or restore saved user data (licenses). 


Content License 

Remarks 

CmStick 

With the CmStick drop-down box, you can select the desired CmStick 

Section Create 

Backup 

By clicking the "Backup now" button, you can perform a backup of all personal 
CmStick User Data (User Data page). A backup file will be created in the defined 
folder (see Configuration Page - Backup) 

Additionally, the date and the time stamp of your last CmStick backup are dis- 
played 
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Section Restore Use this option to restore saved personal license data from a backup file. 

Backup It is also possible to transfer this data to another CmStick. Therefore the new 

CmStick must have the same password as the first CmStick 


CodeMeter WebAdmin Server 

The Server page displays detailed information about all available CodeMeter network licenses. The Server 
page is split into two subsections: 

• Cluster 

• User 

CodeMeter WebAdmin 0*1 


Home Content Configuration Diagnosis Info Help 


Cluster User 


Available Licenses at ’rolf_haenggi’ 


Product 

Code 

Name 

Feature 

Map 

Licenses 

Status 






User 

Limit 

No 

User 

Limit 

Exclu 

sive 

Shared 

Free 


100003 | Bundling Articles 

1 

SecuriKey 

Lite 

Oxl 

1 

0 

0 

0 

0 

1 

| Details | 


100787 | WAVECOM ELEKTRONIK AG 

1 

Standard 

Modes 

Oxf 

1 

0 

0 

0 

0 

1 

Details 


20 

SAT 

Modes 

Oxf 

1 

0 

0 

0 

0 

1 

1 Details 1 


30 

Classifier 

Oxf 

1 

0 

0 

0 

0 

1 

1 Details 1 

80 

W-BV 

Oxf 

1 

0 

0 

0 

0 

1 

1 Details 1 

100 

W-CODE 

Oxf 

2 

0 

0 

0 

0 

2 

Details 


Information last updated on 21.Jul.2008 14:38:49 


The Cluster sub-section. 


Note: Network licenses can only be used if the CodeMeter Runtime Server is started as a network server. 
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Item 

Remarks 

Product Code 

Displays the Product Code 

Name 

Displays the name of the Product Item, normally the name of the product 

Feature Map 

Displays the Feature Map. The Feature Map is used to control the WAVECOM software 
upgrade period 

Licenses 

Displays the total number of network licenses 

User Limit 

Displays the number of licenses that are currently used in the User Limit mode 

No User Limit 

Displays the number of licenses that are currently used in the No User Limit mode 

Exclusive 

Displays the number of licenses that are currently used in the Exclusive mode 

Shared 

Displays the number of licenses that are currently used in the Shared mode 

Free 

Displays the number of licenses that are currently unused 

Details 

Displays detailed information about network licenses in use 





The User sub-section. 


Server User 

Remarks 

CmStick 

Displays the serial number of the connected CmStick 

Firm Item 

Displays information about the Firm Item (Firm Code and text) 

Product Code 

Displays the Product Code 

Client 

Displays the IP address of the current CodeMeter client 

Access Mode 

Displays the current Access Mode 





This screen displays detailed information about the network licenses in use. The upper area displays gen- 
eral information about the selected network licenses. 
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License Details 

Remarks 

ID 

Displays the current CodeMeter process ID on the network server 

Client (User) 

Displays the IP address of the connected CodeMeter clients 

Client Process ID 

Displays the current CodeMeter process ID on the client PC 

Application Information 

Displays application specific information 

Access Mode 

Displays the current Access Mode 

First Access 

Displays the date and time stamp of the first access (client to server) 

Last Access 

Displays the date and time stamp of the last access (client to server) 

Action 

By clicking the "Cancel" button the selected license will be freed 


Important: If a network license that is currently in use is canceled, the associated client application will 
experience an error. Please, ensure that the selected license is not in use. 


CodeMeter WebAdmin Configuration 

The Configuration page is split into six sub-sections: 

• Network 

• Proxy 

• Access Control 

• Certified Time 

• WebAdmin 

• Backup 



The Network sub-section. 


License De- 
tails 

Remarks 

Bind Ad- 

dress 

Select which network adapter (virtual adapter) the CodeMeter Runtime Server will be 
bound to. This is very useful if your PC has several network adapters and it should act as 
a network license server. 

By default, the CodeMeter Runtime Server uses the first detected network adapter (NIC) 

Network 

Port 

Port 22350 is the standard port for CodeMeter communication. You may edit this value if 
required. If changing port number make sure that all CodeMeter Runtime Servers use the 
same port if you want to use an application via the network 

UDP Wait- 
ing Time 

Specifies the maximum UDP wait time. 

This time specifies the maximum time interval within which UDP requests (requests via 
the UDP protocol) must be answered 

Run Net- 

If this option is enabled, the specified PC may be used as a CodeMeter Network Server 
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work Server 


Server 

Search List 

On the Server Search List you can define the access to specific CodeMeter Servers. In this 
case the client only searches for these servers. To do so, just set the DNS name or the IP 
address of the CodeMeter Server in the Server Search List 

If the CodeMeter Server is located in a different subnet, it is strongly recom- 
mended that you use the IP address of the CodeMeter Server in the Server 
Search List 





The Proxy sub-section. 


Configuration 

Proxy 

Remarks 

Proxy support 

Enable or disable Proxy Server support; this option has to be enabled if you are 
using a proxy server 

Proxy Server 

Set the IP address of your proxy server 

Proxy Port 

Set the port number of your proxy server 

Authentication 

Enable or disable the proxy server authentication 

Proxy User 

User ID for the proxy server 

Proxy Password 

User password for the proxy server 


CodeMeter WebAdmin 


Home Content Server iWffrMTTffTiMil Diagnosis Info Help 


Network Proxy Access Control Certified Time WebAdmin Backup 



Access Control 


Clients *: 


| add 1 1 remove "| 

Access FSB*: □ enabled 

| Apply 1 1 Default | 

(*) Changes only take effect after restarting CodeMeter 


The Access Control sub-section. 
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Configuration 

Access Control 

Remarks 

Clients 

Shows a list of all CodeMeter client computers that have permission to use the 
CodeMeter Server (check out a license) 

If this list is empty (default setting), all CodeMeter Clients are allowed to use the 
CodeMeter Server. 

Add, Remove 

To allow a special CodeMeter Client to use the CodeMeter Server, just click on 
the "Add" button and enter the IP address or the DNS name of the client into the 
input box. To remove a Client, highlight its IP address and click "Remove". 

Access FS 

If this feature is enabled (box is checked), CodeMeter Clients or developer PCs 
can access the CodeMeter Firm Security Box (FSB). To disable this feature, un- 
check the check-box 

This feature is only useful for CodeMeter Licensors 





The Certified Time sub-section. 


Configuration Certi- 
fied Time 

Remarks 

Time Server 

Specify the access order or add/remove the IP address or the URL of a CodeMe- 
ter Time Server using the "add", "remove", "up" and "down" buttons 

Time Out 

Set the time out value of the CodeMeter Time Servers 


CodeMeterWebAdmin 


Home Content Server RI!!m!iTTHiT!!i1 Diagnosis Info Help 


Network Proxy Access Control Certified Time WebAdmin Backup 


WebAdmin 

Remote Read *: IZl allowed 
Remote Write *: □ allowed 
Language *: |english j^J 

| Apply 1 1 Default | 

(*) Changes only take effect after restarting CodeMeter 


The WebAdmin sub-section. 


Config. WebAdmin 

Remarks 

Remote Read 

Check this box to allow remote reading of your CodeMeter Runtime Server over the 
network 

Remote Write 

Check this box to allow a remote access to change the configuration settings of 
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your CodeMeter Runtime Server 

Language 

Specify the language used in your CodeMeter WebAdministrator 


CodeMeterWebAdmin ^yj 



The Backup sub-section. 


Config. Backup 

Remarks 

Backup Path 

Specify the Backup Path to which the CmStick backup is written 

The default Backup Path under Windows is [\CodeMeter\Runtime\bin] 

Backup Interval 

Specify the interval (in hours) between CodeMeter automatic backups. The default 
value is 24 hours 

Certified Time 

Check to enable a Certified Time update before each backup 


Note: Manual backups can be done immediately - instructions can be found on the Backup page. 


CodeMeter WebAdmin Diagnosis 

The Contents page is split into two sub-sections: 

• Logfile 

• CmTalk 


CodeMeter WebAdmin 


M 


Logfile CmTalk 


Diagnosis j^rj 


2008-07- 

2008-07- 

2008-07- 

6001) 

2008-07- 

2008-07- 

2008-07- 

2008-07- 

2008-07- 

2008-07- 

2008-07- 

2008-07- 

2008-07- 

2008-07- 

2008-07- 

2008-07- 

2008-07- 

2008-07- 

2008-07- 

2008-07- 

2008-07- 

2008-07- 


21 15:05:41: Logging activated. 

21 15:05:41: CodeMeter for Windows (B3. 30. 051. 501. 32. 140) [3 

21 15:05:41: Running on Microsoft Windows Vista Professional Service Pack 1 (Build 

21 15:05:41: Found IP address: 192.168.1.65 | 127.0.0.1 
21 15:05:41: Used Communication Mode: TCP/IP. 

21 15:05:41: Used IP address: default address 
21 15:05:41: Used IP port: 22350 
21 15:05:41: Run as network server: no 
21 15:05:41: Run as system service: yes 
21 15:05:41: Box Access: use direct access mode. 

21 15:05:42: Access from 127.0.0.1 to Subsystem (Handle 16) 

21 15:05:42: Handle 16 released 

21 15:05:42: Access from 127.0.0.1 to IFI (Handle 16) 

21 15:05:42: Handle 16 released 

21 15:06:15: Access from 127.0.0.1 to Subsystem (Handle 16) 

21 15:06:15: Handle 16 released 

21 15:06:15: Access from 127.0.0.1 to IFI (Handle 16) 

21 15:06:15: Handle 16 released 

21 15:08:06: Access from 127.0.0.1 to Subsystem (Handle 16) 

21 15:08:06: Handle 16 released 

21 15:08:06: Access from 127.0.0.1 to IFI (Handle 16) 


The Logfile sub-section. 

With the enabled option you can activate or deactivate the logging function. 
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If the logging function is activated, the Logfile page displays the contents of the current log file in the Co- 
deMeter installation folder (default: [..\ProgramFiles\CodeMeter\Logs]). 


CodeMeter WebAdmin 

Logfile CmTalk 



CmTalk Test Pages 

The following pages will guide you through the necessary steps to check if you can buy CodeMeter software 

online. 


JavaScript is 


enabled. 


JavaScript is a programming language for use in HTML pages. 

In CodeMeter it is used inside this Web Administrator for display issues and 
in CmTalk for calling local ActiveX or Java objects. 

s 


The CmTalk sub-section. 

This page provides the possibility to test the CmTalk environment. 

The CmTalk protocol is required for the automatic transfer or update of CodeMeter licenses via the Inter- 
net. 

CodeMeter WebAdmin Info 
CodeMeter WebAdmin 



General information regarding the CodeMeter system. 
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Glossary of Terms 

ANSI 

An acronym for the American National Standards Institute, an organization that sets standards for a varie- 
ty of programming languages and systems. 


ASCII 

An acronym for American Standard Code for Information Interchange, pronounced "ASK-ee." It is a code 
in which the numbers from 0 to 127 stand for letters, numbers, punctuation marks and other characters. 
ASCII code is standardized to facilitate transmitting text between computers or between a computer and a 
peripheral device. 

BCH 

A BCH (Bose, Ray-Chaudhuri, Hocquenghem) code is an error-correcting code. It is a multilevel, cyclic, er- 
ror-correcting, variable-length digital code used to correct mutiple random error patterns. 


Convolutional code 

A type of channel coding that adds patterns of redundancy to the data in order to improve the signal-to- 
noise ratio (SNR) for more accurate decoding at the receiving end. The Viterbi algorithm is used to decode 
a particular type of convolutional code 


CRC 

CRC (Cyclical Redundancy Checking) is an error checking technique used to ensure the accuracy of trans- 
mitting digital data. The transmitted messages are divided into predetermined lengths which, used as div- 
idends, are divided by a fixed divisor. The remainder of the calculation is appended onto and sent with the 
message. At the receiving end, the computer recalculates the remainder. If it does not match the trans- 
mitted remainder, an error is detected. 


DEFLATE 


Deflate is a lossless data compression algorithm that uses a combination of the LZ77 algorithm and Huff- 
man coding. 

HDLC 

HDLC (High-level Data Link Control) is a group of protocols for transmitting synchronous data packets be- 
tween point-to-point nodes. In HDLC, data is organized into a frame. HDLC uses zero insertion/deletion 
process (bit stuffing) to ensure that the bit pattern of the delimiter flag does not occur in the fields be- 
tween flags. 

HEX 

In mathematics and computer science, hexadecimal, or simply hex, is a numeral system with a radix or 
base of 16 usually written using the symbols 0-9 and A-F or a-f. 
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Huffman coding 


Huffman coding is an entropy encoding algorithm used for lossless data compression. The term refers to 
the use of a variable-length code table for encoding a source symbol (such as a character in a file) where 
the variable-length code table has been derived in a particular way based on the estimated probability of 
occurrence for each possible value of the source symbol. It was developed by David A. Huffman 


LZ77 

LZ77 is the name for a lossless data compression algorithms published in papers by Abraham Lempel and 
Jacob Ziv. LZ77 algorithms achieve compression by replacing portions of the data with references to 
matching data that has already passed through both encoder and decoder. 


Matlab 

MATLAB is a numerical computing environment and programming language. Created by The MathWorks, 
MATLAB allows easy matrix manipulation, plotting of functions and data, implementation of algorithms, 
creation of user interfaces, and interfacing with programs in other languages. Although it specializes in 
numerical computing, an optional toolbox interfaces with the Maple symbolic engine, allowing it to be part 
of a full computer algebra system. 
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